15 KiB
aadd_conect05: Procesamiento de ficheros JSON y XML con Jackson, JDBC, patrón DAO y Service Layer (MySQL)
Descripción
Proyecto en Java que procesa dos ficheros (un JSON 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 el patrón Service Layer. Todas las sentencias SQL se ejecutan con PreparedStatement y están declaradas como constantes private static final.
Es la evolución de aadd_conect04 con tres novedades:
- Procesamiento con Jackson: el fichero de familias profesionales pasa de CSV a JSON (
ObjectMapper) y el de ciclos formativos se lee con Jackson XML (XmlMapper) en lugar del paquete DOM de Java. En ambos casos se recorre el contenido con la claseJsonNode. - Una clase de servicio por entidad:
FamiliaProfesionalServiceyCicloFormativoService, que aplican las reglas de negocio y gestionan la conexión. - Procesadores de ficheros:
ProcesadorFicheroJSONyProcesadorFicheroXMLleen los ficheros y llaman a los 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_conect05/src/org/palomafp/aadd/dta/AppPrincipal.java: clase principal que lanza el tratamiento de los dos ficherosmodel/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 conPreparedStatement
service/FamiliaProfesionalService.java: casos de uso de familias profesionalesCicloFormativoService.java: casos de uso de ciclos formativos
util/ProcesadorFicheroJSON.java: lee el JSON de familias con Jackson y llama al servicioProcesadorFicheroXML.java: lee el XML de ciclos con Jackson y llama al servicio
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_pro.json: familias profesionales a procesarcatalogo_formacion.xml: ciclos formativos a procesar
Formacion_FP.sql: script de creación de la base de datospom.xmlREADME.md
Dependencias (Maven)
| Dependencia | Uso |
|---|---|
mysql-connector-j |
Driver JDBC de MySQL |
jackson-databind |
ObjectMapper y JsonNode (lectura del JSON) |
jackson-dataformat-xml |
XmlMapper (lectura del XML) |
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 JSON) 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 JSON | 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 → Procesador (util) → Service → DAO → Base de datos
↓
Ficheros (JSON y XML) con Jackson
| Capa | Responsabilidad |
|---|---|
AppPrincipal |
Decide qué se ejecuta y captura la excepción de aplicación. No conoce conexiones, SQL ni ficheros |
| Procesador | Lee el fichero con Jackson, convierte cada nodo en un objeto del modelo y llama al servicio |
| Servicio | Representa los casos de uso. 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 |
| 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 las clases procesadoras.
Componentes principales
FamiliaProfesional,TipoFormacionyCicloFormativo: clases del modelo con sus atributos, constructores, getters, setters ytoString().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.FamiliaProfesionalServiceyCicloFormativoService: abren la conexión contry-with-resources(se cierra sola), crean los DAO pasándosela y aplican la lógica de cada caso de uso. Los fallos al obtener o cerrar la conexión se convierten enFormacionException.ProcesadorFicheroJSONyProcesadorFicheroXML: leen el fichero conObjectMapperyXmlMapperrespectivamente, recorren los nodosJsonNodey construyen los objetos del modelo. Obtienen la ruta deGestorConfiguracion.FormacionException: excepción checked con dos constructores (mensajeymensaje, causa). Es la excepción de aplicación que conocen las capas superiores.GestorConfiguracion: clase de utilidad (constructor privado) que cargaapplication.propertiesdesde el classpath en un bloquestaticy ofrece un getter por propiedad. Las rutas de los ficheros se devuelven comoPath.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 los dos procesadores y los ejecuta 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_pro.json
# 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 de los ficheros son relativas al directorio de ejecución, por lo que el programa debe lanzarse desde la raíz del proyecto.
Ficheros de entrada
JSON de familias profesionales
Fichero cuya raíz es un array de objetos:
[
{
"id_registro": 1,
"fecha_carga": "2026-01-15",
"cod_tipo_fam": "ADG",
"nombre_tf": "Administración y Gestión"
}
]
Solo interesan los campos cod_tipo_fam y nombre_tf. Los demás se ignoran. Los valores se leen con path(...).asText().trim().
| JSON | Columna |
|---|---|
cod_tipo_fam |
codigo |
nombre_tf |
nombre |
XML de ciclos formativos
Los elementos ciclo cuelgan de catalogo_formacion/informacion_adicional/ciclos_formativos. Jackson descarta el elemento raíz, por lo que se navega con path("informacion_adicional").path("ciclos_formativos").path("ciclo"). El atributo cod_cf aparece como un campo más del nodo. Los elementos fecha_actualizacion y observaciones se ignoran. 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
| DAO | Método | Sentencia SQL | Devuelve |
|---|---|---|---|
IFamiliaProfesionalDAO |
existe(String codigo) |
SELECT 1 ... WHERE codigo = ? |
true si existe |
IFamiliaProfesionalDAO |
insertar(familia) |
INSERT con todos los campos |
nada |
IFamiliaProfesionalDAO |
actualizar(familia) |
UPDATE del nombre por código |
nada |
ITipoFormacionDAO |
existe(String codigo) |
SELECT 1 ... WHERE codigo = ? |
true si existe |
ICicloFormativoDAO |
insertar(ciclo) |
INSERT con todos los campos |
nada |
Métodos de los servicios
| Servicio | Método | Acción |
|---|---|---|
FamiliaProfesionalService |
existeFamiliaProfesional(codigo) |
Comprueba si la familia existe en la BBDD |
FamiliaProfesionalService |
insertarFamiliaProfesional(familia) |
Inserta la familia |
FamiliaProfesionalService |
actualizarFamiliaProfesional(familia) |
Actualiza el nombre de la familia |
CicloFormativoService |
insertarCicloFormativo(ciclo) |
Inserta el ciclo solo si existen su familia profesional y su tipo de formación; si no, lanza FormacionException |
Reglas del tratamiento
Familias (ProcesadorFicheroJSON)
- Lee el JSON y recorre el array de nodos.
- Por cada familia, el servicio comprueba si existe en la BBDD.
- Si existe, actualiza su nombre; si no, la inserta.
- Cualquier error (fichero no encontrado, JSON mal formado, fallo SQL) se propaga hasta
AppPrincipal.
Ciclos (ProcesadorFicheroXML)
- Lee el XML y recorre los nodos
ciclo. - Por cada ciclo crea un
CicloFormativocon objetosFamiliaProfesionalyTipoFormacionque solo tienen el código. CicloFormativoServicecomprueba que existen la familia y el tipo en la BBDD.- Si alguno no existe, lanza
FormacionExceptioncon un mensaje descriptivo. El procesador lo captura ciclo a ciclo, informa del error y continúa con el siguiente, de modo que un ciclo erróneo no detiene el tratamiento de los demás. - Si existen ambos, inserta el ciclo.
Métodos de AppPrincipal
| Método | Acción |
|---|---|
main(String[] args) |
Crea y ejecuta ProcesadorFicheroJSON (familias) y después ProcesadorFicheroXML (ciclos). 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 JSON. 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:
Familia profesional actualizada: ADG
Familia profesional insertada: IFC
Familia profesional insertada: TMV
Familia profesional insertada: SAN
ERROR en el ciclo ADGB01: No existe el tipo de formación CFBA del ciclo ADGB01
Ciclo formativo insertado: ADGM01
Ciclo formativo insertado: ADGS01
ERROR en el ciclo IFCB01: No existe la familia profesional IFE del ciclo IFCB01
Ciclo formativo insertado: IFCM01
Ciclo formativo insertado: IFCS02
Ciclo formativo insertado: IFCS03
ERROR en el ciclo IFCES03: No existe el tipo de formación CFE del ciclo IFCES03
Ciclo formativo insertado: TMVB01
Ciclo formativo insertado: TMVM01
Ciclo formativo insertado: TMVS01
Ciclo formativo insertado: TMVES02
ERROR en el ciclo SANM01: No existe el tipo de formación CFME del ciclo SANM01
Ciclo formativo insertado: SANS01
Ciclos formativos insertados: 10 de 14
Aspectos a tener en cuenta
- Se asume que no hay ciclos formativos en la base de datos. Si se ejecuta
AppPrincipaldos veces seguidas, los ciclos ya insertados darán 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 hacen los servicios.
AppPrincipalno conoce JDBC ni los ficheros. - Cada método de servicio abre y cierra su propia conexión; no hay transacción compartida entre operaciones.
- Hay una única excepción de aplicación,
FormacionException, que se propaga desde los DAO, los servicios y los procesadores hastaAppPrincipal. - La carpeta
configestá configurada como source folder en Eclipse, por lo que el properties está 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_pro.jsonycatalogo_formacion.xml. - Actualizar las dependencias Maven (Maven → Update Project en Eclipse).
- Ejecutar
AppPrincipalcomo aplicación Java, desde la raíz del proyecto. - Comprobar en la consola la salida (
Ciclos formativos insertados: 10 de 14). - 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