Files
aadd_fic11/README.md
T
2026-10-22 13:32:10 +02:00

57 lines
2.6 KiB
Markdown

# aadd_fic11: Tratamiento de ficheros XML con DOM
## Descripción
Programa en Java que lee el fichero `informacion-IES.xml` mediante la API DOM (`org.w3c.dom`) y muestra su contenido a través de un menú interactivo con `Scanner`.
La ruta del XML no está fija en el código: se obtiene de `config/application.properties` a través de la clase `GestorConfiguracion`.
## Estructura del proyecto
- `Ficheros_11/`
- `config/`
- `application.properties`: ruta del fichero XML
- `src/org/palomafp/aadd/dta/`
- `Main.java`: menú y lectura con DOM
- `gestores/GestorConfiguracion.java`: carga del properties
- `informacion-IES.xml`: fichero XML de datos
- `0111_ficheros.pdf`: parte A (investigación)
- `README.md`
## Componentes principales
- **`Main`**: carga el XML con DOM (`DocumentBuilderFactory`, `DocumentBuilder`, `Document`), muestra el menú y ejecuta la opción elegida.
- **`GestorConfiguracion`**: clase estática que carga `application.properties` y devuelve la ruta del XML.
- **`application.properties`**: contiene la clave `ies.ruta.fichero=informacion-IES.xml`.
## Clases utilizadas en `Main`
| Clase | Paquete | Uso |
|---|---|---|
| `DocumentBuilderFactory` | `javax.xml.parsers` | Crea la fábrica del parser XML |
| `DocumentBuilder` | `javax.xml.parsers` | Analiza el fichero XML (`parse`) y genera el `Document` |
| `Document` | `org.w3c.dom` | Representa el árbol XML completo en memoria |
| `Element` | `org.w3c.dom` | Representa una etiqueta; permite leer atributos (`getAttribute`) y buscar etiquetas hijas (`getElementsByTagName`) |
| `NodeList` | `org.w3c.dom` | Lista de nodos; se recorre con `getLength()` e `item(i)` |
| `Path` | `java.nio.file` | Ruta del fichero XML obtenida del properties |
| `Scanner` | `java.util` | Lectura de la opción elegida por teclado |
## Opciones del menú
| Opción | Acción | Información mostrada |
|---|---|---|
| 1 | Imprimir instituto | Nombre y tipo del instituto |
| 2 | Imprimir ciclos | Código y nombre corto de cada ciclo |
| 3 | Imprimir módulos filtro 1 | Id, referencia, título y horas de los módulos cuyo título empieza por "Programa" |
| 4 | Imprimir módulos filtro 2 | Igual que la opción 3, pero solo de los módulos del curso 1 |
| 0 | Salir | Cierra el programa |
El menú se repite después de cada opción hasta que se elige `0`. Cualquier otra entrada (letras u otros números) muestra "Opción inválida." y vuelve a mostrar el menú.
## Ejecución
1. Comprobar que la carpeta `config` está marcada como *source folder*.
2. Comprobar que `informacion-IES.xml` está en la raíz del proyecto.
3. Ejecutar la clase `org.palomafp.aadd.dta.Main`.