# 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`: ```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 `` que es hijo directo de la raíz ``, evitando los `` 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 `` con el `` del instituto | | 2 | `resumen_ciclos_IES.xml` | Raíz `` con el instituto (atributo `tipo`) y un `` por cada ciclo con su nombre corto | | 3 | `modulos1_ciclo_DAM.xml` | Raíz `` (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 `` con `` | Raíz `` con atributo `nombre` | | `` | `` | | `` (elemento) | atributo `numero_horas` del `` | | `` con `familia` y `numero_horas` | `` solo con `codigo` y `nivel` | Los módulos se leen buscando por nombre de etiqueta (no por posición), porque el orden de `` y `` 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 ``, mediante `getChildNodes()`. Los comentarios de `` 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 `` en dos sitios: como hijos de `` (aulas) y dentro de `` (asignaturas). Por eso se busca siempre dentro del `` correspondiente. - Hay dos tipos de ``: 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 `` y `` 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.