17 KiB
RedMetroDTA: Red de Metro con JDBC, patrón DAO, capa de servicios y ficheros CSV/XML (MySQL)
Descripción
Proyecto en Java que gestiona información de la red de Metro de Madrid sobre la base de datos red_metro_dta, 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 (Service Layer). Todas las sentencias SQL se ejecutan con PreparedStatement.
La aplicación pide por teclado la operación a realizar y ofrece cuatro casos de uso:
| Operación | Caso de uso |
|---|---|
A |
Consultar el color de una línea (el identificador se pide por teclado) |
B |
Tratar el fichero CSV de cocheras (insertar, modificar o borrar según el código de operación) |
C |
Cargar en la base de datos los trenes del fichero XML |
D |
Obtener todos los trenes de la base de datos y generar un fichero XML |
Características del proyecto:
- Procesamiento de ficheros: lectura de un CSV (cocheras) y de un XML con DOM (trenes), y generación de un XML con DOM y
Transformer. - Fichero de configuración: conexión a la base de datos, rutas de los ficheros y separador del CSV. No hay literales de configuración en el código.
- Modelo orientado a objetos: cuando hay clave foránea, la clase guarda una referencia al objeto, no su código (
Trenguarda unaCocheray unaLinea;Lineaguarda unColor). - Excepción de aplicación
RedMetroException(checked), única excepción que sale de las capas de acceso a datos, ficheros y servicios.
Los datos de conexión y las rutas no están escritos en el código: se leen del fichero app.properties a través de la clase GestorConfiguracion.
Estructura del proyecto
RedMetroDTA/src/es/madrid/redmetro/dta/AppPrincipal.java: clase principal; pide la operación por teclado y la ejecutamodel/Color.java,Cochera.java,Linea.java,Tren.java: clases del modelo usadas por los casos de usoEstacion.java,Acceso.java,LineaEstacion.java: clases del modelo de las restantes tablas (no intervienen en ningún caso de uso)
dao/ILineaDAO.java,ICocheraDAO.java,ITrenDAO.java: interfaces de los DAOLineaDaoJDBC.java,CocheraDaoJDBC.java,TrenDaoJDBC.java: implementaciones JDBC conPreparedStatement
service/LineaService.java: caso de uso ACocheraService.java: operaciones de cocheras (caso de uso B)TrenService.java: operaciones de trenes (casos de uso C y D)
util/ProcesadorFicheroCSV.java: trata el CSV de cocherasProcesadorFicheroXML.java: lee el XML de trenes y genera el XML de salida
excepciones/RedMetroException.java: excepción de aplicación (checked)
gestores/GestorConfiguracion.java: cargaapp.propertiesy expone sus valoresGestorConexionBBDD.java: crea las conexiones a la base de datos
config/app.properties: configuración (conexión a la BBDD, rutas de ficheros y separador)
ficheros/operaciones-cocherasRM.csv: operaciones sobre cocherastrenes_estaciones_accesos.xml: trenes, estaciones y accesos (solo se usan los trenes)red_metro_dta.xml: fichero generado por la operación D
aadd-redmetro.sql: script de creación de la base de datospom.xmlREADME.md
Base de datos
El script SQL crea la base de datos con siete tablas:
| Tabla | Columnas |
|---|---|
T_COLOR |
cod_color (PK), nombre, cod_hexadecimal |
T_COCHERA |
cod_cochera (PK), nombre, direccion, deposito (1 o 0) |
T_ESTACION |
cod_estacion (PK), nombre, direccion |
T_ACCESO |
cod_acceso (PK), nombre, acceso_discapacidad (1 o 0), cod_estacion (FK a T_ESTACION) |
T_LINEA |
cod_linea (PK), nombre_corto, nombre_largo, cod_color (FK a T_COLOR), kilometros |
T_TREN |
cod_tren (PK), modelo, empresa_constructora, fecha_incorporacion, cod_cochera (FK a T_COCHERA), cod_linea (FK a T_LINEA) |
T_LINEA_ESTACION |
cod_linea y cod_estacion (PK compuesta, FK a T_LINEA y T_ESTACION), orden |
Tras ejecutar el script, la base de datos contiene los 13 colores, 7 líneas y 23 cocheras. No contiene trenes, estaciones ni accesos.
Origen y destino de los datos
| Información | Origen | Destino |
|---|---|---|
| Color de una línea | Base de datos (T_LINEA y T_COLOR) |
Consola |
| Cocheras | Fichero CSV | T_COCHERA |
| Trenes | Fichero XML | T_TREN |
| Trenes con su línea y color | Base de datos | Fichero XML generado |
Arquitectura en capas
AppPrincipal → Service → DAO → Base de datos
│
└→ Procesadores de ficheros (util) → Service → DAO
│
└→ Ficheros (CSV y XML)
| Capa | Responsabilidad |
|---|---|
AppPrincipal |
Pide la operación por teclado, decide qué se ejecuta y captura RedMetroException en un único punto |
Procesadores (util) |
Leen y escriben los ficheros CSV y XML. Convierten su contenido en objetos del modelo y llaman a los servicios |
| Servicio | Abre y cierra la conexión y crea el DAO pasándosela. Representa los casos de uso sobre la base de datos |
| 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, con referencias a otros objetos cuando hay clave foránea |
El patrón DAO se usa únicamente para el acceso a la base de datos. Los ficheros se tratan en los procesadores, que no usan DAO.
Componentes principales
Color,Cochera,Linea,Tren: clases del modelo con constructor vacío, constructor completo, getters, setters ytoString.Lineaguarda un objetoColoryTrenguarda un objetoCocheray un objetoLinea.Tren.fechaIncorporaciones unLocalDate.ILineaDAO,ICocheraDAOeITrenDAO: interfaces con las operaciones de acceso a datos. Todos sus métodos declaranthrows RedMetroException.LineaDaoJDBC,CocheraDaoJDBCyTrenDaoJDBC: implementaciones JDBC. Reciben laConnectionpor constructor y la guardan en un atributoprivate final. Las sentencias SQL son constantes de la clase y cada método crea unPreparedStatementcontry-with-resources. LasSQLExceptionse capturan y se relanzan envueltas enRedMetroException, conservando la causa original.LineaService,CocheraServiceyTrenService: cada método abre la conexión contry-with-resources(se cierra sola), crea el DAO pasándosela y delega en él. Los fallos al abrir o cerrar la conexión también se convierten enRedMetroException.ProcesadorFicheroCSV: lee el CSV conFiles.readAllLinesy, por cada línea, construye unaCocheray ejecuta la operación indicada mediante unswitchcon sintaxis de flecha.ProcesadorFicheroXML: carga el árbol DOM del XML de trenes e inserta cada tren a través deTrenService(operación C). También genera el XML de salida a partir de los trenes de la base de datos (operación D).RedMetroException: excepción checked con dos constructores (mensajeymensaje, causa). Es la única que conocen las capas superiores.GestorConfiguracion: clase de utilidad (constructor privado) que cargaapp.propertiesen un bloquestaticy ofrece un getter por propiedad. Si el fichero no existe o no se puede leer, lanza unaRuntimeException. Las rutas 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: pide por teclado la operación a realizar (A, B, C o D, sin distinguir mayúsculas) y delega su ejecución: la A enLineaServicey las demás en los procesadores de ficheros. No conoce JDBC ni los ficheros. CapturaRedMetroExceptionen un único punto.
Configuración
Fichero app.properties:
# Información relativa a la base de datos
sgbd.conexion.url=jdbc:mysql://192.168.1.62:3306/
bbdd.nombre=red_metro_dta
bbdd.usuario=myuser
bbdd.clave=mypass
# Información relativa a cocheras
cochera.ruta.fichero=ficheros/operaciones-cocherasRM.csv
cochera.csv.separador=;
# Información relativa a trenes
tren.ruta.fichero=ficheros/trenes_estaciones_accesos.xml
tren.ruta.fichero.salida=ficheros/red_metro_dta.xml
- La URL de conexión se forma concatenando
sgbd.conexion.urlybbdd.nombre, es decir,jdbc:mysql://192.168.1.62:3306/red_metro_dta. 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.
- La carpeta
configdebe estar en el classpath para quegetResourceAsStreamencuentreapp.properties. Se declara como source folder en Eclipse.
Ficheros de entrada
CSV de cocheras
Fichero con cabecera y separador ;:
OPERACION;COD_COCHERA;DEPOSITO;DENOMINACION;LOCALIZACION
Los códigos de operación son:
| Operación | Qué hace |
|---|---|
0 |
No hacer nada |
1 |
Insertar la cochera siempre que no exista en la base de datos |
2 |
Modificar la cochera |
3 |
Borrar la cochera |
Los campos se limpian con trim(), las líneas en blanco se ignoran (isBlank()) y cualquier otro código de operación se ignora. Un valor numérico incorrecto o una línea con menos campos de los esperados produce una RedMetroException.
XML de trenes
Los elementos tren cuelgan de trenes. Correspondencia con la tabla T_TREN:
| XML | Columna |
|---|---|
atributo id |
cod_tren |
modelo |
modelo |
anyo_incorporacion |
fecha_incorporacion (1 de enero de ese año) |
empresa_constructora |
empresa_constructora |
cod_cochera |
cod_cochera |
id_linea |
cod_linea |
Las secciones estaciones y accesos del fichero no se procesan.
Fichero XML generado
La operación D genera ficheros/red_metro_dta.xml con esta estructura:
<?xml version="1.0" encoding="UTF-8"?>
<info-trenes-linea-color>
<trenes>
<tren id="1">
<modelo>Serie 2000-A</modelo>
<anyo_incorporacion>2000</anyo_incorporacion>
<empresa_constructora>CAF</empresa_constructora>
<cod_cochera>15</cod_cochera>
<linea id_linea="5">
<nombre_l>Arguelles - Pinar de Chamartín</nombre_l>
<color cod_hex="#741013" id="4">
<descripcion>Marrón</descripcion>
</color>
</linea>
</tren>
</trenes>
</info-trenes-linea-color>
| XML | Origen |
|---|---|
tren/@id |
T_TREN.cod_tren |
anyo_incorporacion |
Año de T_TREN.fecha_incorporacion |
linea/@id_linea |
T_LINEA.cod_linea |
nombre_l |
T_LINEA.nombre_largo |
color/@id y color/@cod_hex |
T_COLOR.cod_color y T_COLOR.cod_hexadecimal |
descripcion |
T_COLOR.nombre |
El serializador DOM ordena los atributos alfabéticamente, por lo que cod_hex aparece antes que id.
Métodos de los DAO
| DAO | Método | Sentencia SQL | Devuelve |
|---|---|---|---|
ILineaDAO |
obtenerPorCodigo(int codLinea) |
SELECT con JOIN a T_COLOR |
La línea con su color, o null si no existe |
ICocheraDAO |
existe(int codCochera) |
SELECT COUNT(*) |
true si existe |
ICocheraDAO |
insertar(Cochera) |
INSERT con todos los campos |
nada |
ICocheraDAO |
modificar(Cochera) |
UPDATE de los campos no clave por código |
nada |
ICocheraDAO |
borrar(int codCochera) |
DELETE ... WHERE cod_cochera = ? |
nada |
ITrenDAO |
insertar(Tren) |
INSERT con todos los campos |
nada |
ITrenDAO |
obtenerTodos() |
SELECT con JOIN a T_COCHERA, T_LINEA y T_COLOR |
List<Tren> con cochera, línea y color cargados |
Solo se incluyen las operaciones necesarias para los cuatro casos de uso.
Casos de uso
A: color de una línea
AppPrincipalpide el identificador de la línea y comprueba que sea un número.LineaService.obtenerLineaobtiene la línea con su color a través deILineaDAO.- Si no existe, se informa de ello. Si existe, se imprime el color junto a la línea.
Ejemplo con el identificador 13:
El color de la Línea 13 (Metrour), que tiene una longitud de 10.75 Kilómetros, es Verde oliva (#7f7f01).
B: tratamiento del CSV de cocheras
ProcesadorFicheroCSV.realizarTratamientoCocheras() recorre el fichero (sin la cabecera) y, según el código de operación, llama a CocheraService:
- Insertar: solo si
existeCocheradevuelvefalse. - Modificar y borrar: se ejecutan directamente.
Con la base de datos recién creada, el tratamiento modifica la cochera 1 y borra la 13. Las inserciones se omiten porque las cocheras ya existen.
C: carga de trenes desde el XML
ProcesadorFicheroXML.realizarTratamientoTrenes() recorre los elementos tren, construye cada Tren con una Cochera y una Linea que solo llevan el código y lo inserta con TrenService. Con el fichero de ejemplo se insertan los cuatro trenes.
D: generación del XML de trenes
ProcesadorFicheroXML.generarFicheroTrenes() obtiene todos los trenes con TrenService, construye el árbol DOM y lo escribe con Transformer en la ruta de salida configurada.
Salida por consola
Ejemplo de la operación B con la base de datos recién creada:
Introduzca la operación a realizar:
B
Modificando la cochera: Cochera [codCochera=1, nombre=PUERTA DE ARGANDA, direccion=CARRETERA M-203 KM 2,300 (CAMINO DE VALLECAS A MEJORADA), deposito=1]
Borrando la cochera: Cochera [codCochera=13, nombre=PLAZA DE CASTILLA, direccion=SAN BENITO S/N, deposito=0]
Ejemplo de la operación C con la base de datos recién creada (una línea por cada tren del XML; se muestran el primero y el último):
Introduzca la operación a realizar:
C
Insertando el tren: Tren [codTren=1, modelo=Serie 2000-A, empresaConstructora=CAF, fechaIncorporacion=2000-01-01, cochera=Cochera [codCochera=15, nombre=null, direccion=null, deposito=0], linea=Linea [codLinea=5, nombreCorto=null, nombreLargo=null, kilometros=0.0, color=null]]
...
Insertando el tren: Tren [codTren=4, modelo=Serie 5000, empresaConstructora=CAF, fechaIncorporacion=2010-01-01, cochera=Cochera [codCochera=1, nombre=null, direccion=null, deposito=0], linea=Linea [codLinea=9, nombreCorto=null, nombreLargo=null, kilometros=0.0, color=null]]
La cochera y la línea solo muestran su código porque el XML no trae el resto de sus datos. En la base de datos se guardan únicamente esos códigos, que son las claves foráneas de T_TREN.
Ejemplo de la operación D:
Introduzca la operación a realizar:
D
Fichero generado: ficheros\red_metro_dta.xml
Aspectos a tener en cuenta
- La operación C inserta los trenes sin comprobar si existen. Si se ejecuta dos veces seguidas, la segunda fallará con un error de clave duplicada. Para repetir la prueba hay que volver a ejecutar el script SQL.
- La operación D debe ejecutarse después de la C. Si no hay trenes en la base de datos, el XML generado queda vacío.
- Los DAO no abren ni cierran la conexión; lo hace el servicio.
AppPrincipalno conoce JDBC. - Se abre una conexión por operación de servicio, por lo que el tratamiento del CSV y del XML usa una conexión distinta por cada fila o tren. No hay transacción global.
- La fecha de incorporación del XML solo trae el año, por lo que se guarda como el 1 de enero de ese año. Al generar el XML solo se escribe el año.
- Hay una única excepción de aplicación,
RedMetroException, que se propaga desde los DAO y los procesadores hastaAppPrincipal. - La clase
GestorConfiguracionlanza unaRuntimeExceptiondesde su bloquestatic, porque un fichero de configuración ausente es un error de despliegue y no de acceso a datos.
Ejecución
- Ejecutar el script SQL en un cliente MySQL (DBeaver) sobre la base de datos
red_metro_dta. - Crear el usuario con permisos sobre la base de datos:
CREATE USER 'myuser'@'%' IDENTIFIED BY 'mypass'; GRANT ALL PRIVILEGES ON red_metro_dta.* TO 'myuser'@'%'; FLUSH PRIVILEGES; - Ajustar
config/app.propertiesa la IP y credenciales del servidor MySQL. - Comprobar que
ficheros/contieneoperaciones-cocherasRM.csvytrenes_estaciones_accesos.xml. - Ejecutar
AppPrincipalcomo aplicación Java, desde la raíz del proyecto, y probar las operaciones en este orden:A,B,CyD. - Comprobar en la base de datos:
SELECT * FROM T_COCHERA ORDER BY cod_cochera; -- 22 filas: falta la cochera 13 SELECT * FROM T_TREN; -- 4 trenes tras la operación C - Para repetir las pruebas desde cero, volver a ejecutar el script SQL.