6. Persistencia documental XML

6.1. ¿De qué va este tema?

Retomaremos XML para organizar y gestionar documentos en una base nativa. Desarrollaremos su componente y consolidaremos las pruebas, documentación e integración de las persistencias construidas durante el módulo.

Dedicación orientativa: unas 48 horas. El tiempo que necesites dependerá de tus conocimientos previos y de las dificultades que encuentres.

Punto de partida: formatos de intercambio y componentes de los cursos anteriores.

6.2. Clases

6.2.1. Retomar XML como formato de intercambio

  • Elementos, atributos, jerarquía y espacios de nombres.

  • Estructura y valores de un documento.

Actividad

  • Documento bien formado y validez; parser y modelo de objetos.

  • Lectura, escritura y localización de errores sintácticos.

Actividad

6.2.2. Cuándo usar una base documental nativa

  • Documento y colección frente a archivo, tabla y objeto.

  • Unidad de almacenamiento y estructura variable.

Actividad

  • Consultas documentales, ventajas y límites.

  • Base XML nativa frente a columna XML o almacén documental genérico.

Actividad

6.2.3. Instalar y preparar el gestor XML

  • Instalación, servicio, almacenamiento y configuración.

  • Entorno de pruebas reproducible.

Actividad

  • Usuario, permisos y comprobación mínima.

  • Registro de configuración y límites del entorno.

Actividad

6.2.4. Conectar desde la aplicación

  • Controlador o API, endpoint y autenticación.

  • Apertura de acceso desde el proyecto.

Actividad

  • Configuración externa, errores y liberación de recursos.

  • Éxito, fallo y preservación de la causa original.

Actividad

6.2.5. Colecciones, documentos e identificadores

  • Colección, ruta, nombre e identidad del documento.

  • Organización documental mínima.

Actividad

  • Estructura variable, identificadores, referencias y colisiones.

  • Nombre de documento frente a identificador de negocio.

Actividad

6.2.6. Crear y eliminar colecciones

  • Existencia, creación y permisos.

  • Preparación de una colección desde la aplicación.

Actividad

  • Borrado, contenido y comportamiento del gestor.

  • Colección inexistente o no vacía y comprobación posterior.

Actividad

6.2.7. Contrato del componente documental

  • Operaciones, identificador, resultado y error.

  • Contrato de persistencia documental.

Actividad

  • Implementación, configuración y operaciones de colección.

  • Cliente independiente de la API del gestor.

Actividad

6.2.8. Incorporar documentos XML

  • Contenido, codificación y comprobación sintáctica.

  • Importación en una colección preparada.

Actividad

  • Identificador, duplicados y relectura.

  • Alta mediante el componente y comprobación desde otra conexión.

Actividad

6.2.9. Modificar contenido documental

  • Selección mínima de nodo y localización del contenido.

  • Alcance de la modificación prevista.

Actividad

  • Actualización localizada y reemplazo del documento según la API.

  • Comprobación de contenido y estructura tras el cambio.

Actividad

6.2.10. Eliminar documentos y conservar referencias

  • Identidad, permisos y documento inexistente.

  • Borrado por identificador.

Actividad

  • Referencias, resultado y comprobación posterior.

  • Diferencia entre eliminar documento y colección.

Actividad

6.2.11. Errores y consistencia documental

  • Sintaxis, permisos, duplicados y operación parcial.

  • Clasificación y comunicación de fallos.

Actividad

  • Transacciones y actualización atómica cuando estén soportadas.

  • Reversión, recuperación y garantías efectivas de la API.

Actividad

6.2.12. Consultar documentos y nodos

  • Rutas, predicados, espacios de nombres y lenguaje del gestor.

  • Selección de contenidos documentales.

Actividad

  • Parámetros y ejecución desde la API de consulta.

  • Resultado vacío, coincidencia única y varias coincidencias.

Actividad

6.2.13. Resultados e índices documentales

  • Proyección, combinación sencilla y secuencia de resultados.

  • Conversión al contrato y liberación de recursos.

Actividad

  • Índices, consulta y observación del gestor.

  • Equivalencia del resultado frente a cambios en el acceso.

Actividad

6.2.14. Probar y documentar los componentes

  • Pruebas de contrato, casos normales, límites y fallos.

  • Aislamiento y batería común para las distintas implementaciones.

Actividad

  • Documentación de configuración, dependencias, contratos y errores.

  • Revisión de reproducción y lagunas de uso.

Actividad

6.2.15. Integrar y sustituir persistencias

  • Empaquetado, dependencias y selección por configuración.

  • Integración del componente documental en la aplicación.

Actividad

  • Sustitución de implementaciones y ejecución de casos de negocio.

  • Diagnóstico de incompatibilidades del contrato.

Actividad

6.2.16. Revisar la persistencia documental

  • Recorrido de conexión, colecciones, documentos y consultas.

  • Comprobaciones que demuestran cada operación.

Actividad

  • Coherencia de componente, pruebas y documentación.

  • Elección de persistencia y límites de sus garantías.

Actividad

Test de autoevaluación

Actividad final integradora