Files
2026-10-27 10:33:17 +01:00

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 XML
      • gestores/
        • GestorConfiguracion.java: carga application.properties y expone la ruta del XML
    • config/
      • application.properties: configuración (ruta del fichero de entrada)
    • informacion-IES_v2.xml: fichero de entrada
    • README.md

Ficheros generados al ejecutar el programa:

  • info_IES.xml
  • resumen_ciclos_IES.xml
  • modulos1_ciclo_DAM.xml
  • informe_ciclos_IES.txt

Componentes principales

  • AppPrincipal: carga el XML en un Document y muestra el menú. Cada opción llama a un método que crea su fichero de salida.
  • GestorConfiguracion: clase de utilidad (constructor privado) que carga application.properties en un bloque static y devuelve la ruta del XML como Path.

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_NODE que son hijos directos de cada <ciclo>, mediante getChildNodes(). 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 StringBuilder y se escribe con Files.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 (con nombre_corto y nombre_largo).
  • Algunos ids de módulo están repetidos (por ejemplo 14 en 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

  1. Colocar informacion-IES_v2.xml en la raíz del proyecto y comprobar que application.properties está en el classpath.
  2. Ejecutar AppPrincipal.
  3. Elegir una opción del menú (1-4) o 0 para salir.
  4. Los ficheros se generan en el directorio de trabajo del proyecto.