5.6 KiB
aadd_fic12: Tratamiento de ficheros XML con DOM (lectura/escritura)
Descripción
Proyecto en Java que lee el fichero informacion-IES_v2.xml con el API DOM (org.w3c.dom) y, a través de un menú por consola (clase Scanner), genera cuatro ficheros de salida: tres en formato XML construidos con DOM y un informe de texto con los comentarios de cada ciclo formativo.
La ruta del fichero de entrada no está escrita en el código: se lee del fichero application.properties a través de la clase GestorConfiguracion. No se utiliza el patrón DAO.
Estructura del proyecto
Ficheros_12/src/org/palomafp/aadd/dta/AppPrincipal.java: clase principal con el menú y el tratamiento del XMLgestores/GestorConfiguracion.java: cargaapplication.propertiesy expone la ruta del XML
config/application.properties: configuración (ruta del fichero de entrada)
informacion-IES_v2.xml: fichero de entradaREADME.md
Ficheros generados al ejecutar el programa:
info_IES.xmlresumen_ciclos_IES.xmlmodulos1_ciclo_DAM.xmlinforme_ciclos_IES.txt
Componentes principales
AppPrincipal: carga el XML en unDocumenty muestra el menú. Cada opción llama a un método que crea su fichero de salida.GestorConfiguracion: clase de utilidad (constructor privado) que cargaapplication.propertiesen un bloquestaticy devuelve la ruta del XML comoPath.
Configuración
Fichero application.properties:
ies.ruta.fichero=informacion-IES_v2.xml
Si falta la propiedad, getRutaFicheroIes() lanza una IllegalStateException con un mensaje descriptivo.
Métodos de GestorConfiguracion
| Método | Acción |
|---|---|
bloque static |
Carga application.properties desde el classpath. Si no existe o no se puede leer, lanza una RuntimeException |
getRutaFicheroIes() |
Devuelve como Path el valor de ies.ruta.fichero |
Métodos de AppPrincipal
| Método | Acción |
|---|---|
main(String[] args) |
Obtiene la ruta, carga el XML y repite el menú hasta que se elige 0. Los errores de una opción se capturan dentro del bucle y no cierran el programa; los de arranque terminan la ejecución |
mostrarMenu() |
Imprime las opciones del menú |
cargarXml(Path ruta) |
Parsea el fichero con DocumentBuilder y devuelve el Document normalizado. No ignora comentarios, porque la opción 4 los necesita |
guardarXml(Document doc, Path destino) |
Vuelca un Document a fichero con Transformer (UTF-8, indentado a 4 espacios, sin standalone="no") |
obtenerNombreIes(Document doc) |
Devuelve el texto del <nombre> que es hijo directo de la raíz <instituto>, evitando los <nombre> de los ciclos |
crearFicheroInformacionInstituto(Document doc) |
Opción 1. Crea info_IES.xml |
crearFicheroResumenCiclos(Document doc) |
Opción 2. Crea resumen_ciclos_IES.xml |
crearFicheroModulosDam(Document doc) |
Opción 3. Crea modulos1_ciclo_DAM.xml |
crearFicheroInformeCiclos(Document doc) |
Opción 4. Crea informe_ciclos_IES.txt |
Opciones del menú
| Opción | Fichero generado | Contenido |
|---|---|---|
| 1 | info_IES.xml |
Raíz <instituto> con el <nombre> del instituto |
| 2 | resumen_ciclos_IES.xml |
Raíz <resumen> con el instituto (atributo tipo) y un <ciclo codigo="..."> por cada ciclo con su nombre corto |
| 3 | modulos1_ciclo_DAM.xml |
Raíz <ies> (atributos nombre y tipo) con el ciclo DAM y los módulos de su primer curso |
| 4 | informe_ciclos_IES.txt |
Informe con código, nombre corto y observaciones de cada ciclo |
| 0 | — | Salir |
Detalle de la opción 3
El formato de salida cambia respecto al original:
| Original | Salida |
|---|---|
Raíz <instituto> con <nombre> |
Raíz <ies> con atributo nombre |
<curso numero="1"> |
<curso num="1"> |
<numerohoras> (elemento) |
atributo numero_horas del <modulo> |
<ciclo> con familia y numero_horas |
<ciclo> solo con codigo y nivel |
Los módulos se leen buscando por nombre de etiqueta (no por posición), porque el orden de <titulo> y <numerohoras> cambia entre módulos. Se aplica trim() a los textos para eliminar espacios sobrantes.
Detalle de la opción 4
- Solo se recogen los nodos
Node.COMMENT_NODEque son hijos directos de cada<ciclo>, mediantegetChildNodes(). Los comentarios de<curso>o los externos al ciclo no se incluyen. - Se muestran todos los ciclos, aunque alguno no tenga observaciones.
- El informe se construye en un
StringBuildery se escribe conFiles.writeString(UTF-8).
Aspectos a tener en cuenta del XML de entrada
- Hay elementos
<modulo>en dos sitios: como hijos de<instituto>(aulas) y dentro de<curso>(asignaturas). Por eso se busca siempre dentro del<curso>correspondiente. - Hay dos tipos de
<nombre>: el del instituto (texto) y el de cada ciclo (connombre_cortoynombre_largo). - Algunos ids de módulo están repetidos (por ejemplo
14en DAM). Es un dato del fichero y se copian tal cual. - En DAM hay un comentario entre
<nombre>y<curso>cuyo texto dice no ser hijo directo del ciclo, pero estructuralmente sí lo es, por lo que aparece en el informe. - El orden de los atributos en los ficheros generados lo decide el
Transformer; no tiene significado en XML.
Ejecución
- Colocar
informacion-IES_v2.xmlen la raíz del proyecto y comprobar queapplication.propertiesestá en el classpath. - Ejecutar
AppPrincipal. - Elegir una opción del menú (1-4) o
0para salir. - Los ficheros se generan en el directorio de trabajo del proyecto.