first commit
This commit is contained in:
@@ -0,0 +1,106 @@
|
||||
# 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 `<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.
|
||||
Reference in New Issue
Block a user