XML SAX

SAX ADD PROCESSING INSTRUCTION ( documento : Time ; instruccion : Text )
SAX ADD XML CDATA ( documento : Time ; datos : Blob, Text )
SAX ADD XML COMMENT ( documento : Time ; comentario : Text )
SAX ADD XML DOCTYPE ( documento : Time ; docType : Text )
SAX ADD XML ELEMENT VALUE ( documento : Time ; datos : Text, Variable, Field {; *} )
SAX CLOSE XML ELEMENT ( documento : Time )
SAX GET XML CDATA ( documento : Time ; valor : Text, Blob )
SAX GET XML COMMENT ( documento : Time ; comentario : Text )
SAX GET XML DOCUMENT VALUES ( documento : Time ; codificacion : Text ; version : Text ; autonomo : Boolean )
SAX GET XML ELEMENT ( documento : Time ; nombre : Text ; prefijo : Text ; nomsAtributos : Text array ; valoresAtributos : Text array )
SAX GET XML ELEMENT VALUE ( documento : Time ; valor : Variable, Field )
SAX GET XML ENTITY ( documento : Time ; nombre : Text ; valor : Text )
SAX Get XML node ( documento : Time ) : Integer
SAX GET XML PROCESSING INSTRUCTION ( documento : Time ; nombre : Text ; valor : Text )
SAX OPEN XML ELEMENT ( documento : Time ; etiqueta : Text {; nomAtrib : Text ; valorAtrib : Text} {; ...(nomAtrib : Text, valorAtrib : Text)} )
SAX OPEN XML ELEMENT ARRAYS ( documento : Time ; etiqueta : Text {; arrayNomsAtrib : Text array ; arrayValoresAtrib : Array} {; ...(arrayNomsAtrib : Text array, arrayValoresAtrib : Array)} )
SAX SET XML DECLARATION ( documento : Time ; codificacion : Text {; autonomo : Boolean} )

Visión general de los comandos XML SAX

Consulte la sección XML, DOM y SAX para obtener una definición de XML SAX.

Creación, apertura y cierre de documentos XML mediante SAX

Los comandos SAX funcionan con las referencias de documento estándar de 4D (DocRef, una referencia de tipo Time). Por tanto, es posible utilizar estos comandos conjuntamente con los comandos 4D utilizados para gestionar documentos, como SEND PACKET o Append document.

La creación y apertura de documentos XML por programación se lleva a cabo utilizando los comandos Create document y Open document. Posteriormente, el uso de un comando XML con estos documentos provocará la activación automática de mecanismos XML como la codificación. Por ejemplo, la codificación <?xml version="1.0" encoding="… encodage …" standalone = "no "?> el encabezado se escribirá automáticamente en el documento.

nota

Los documentos que leen los comandos SAX deben abrirse en modo de solo lectura mediante el comando Open document. Esto evita cualquier conflicto entre 4D y la biblioteca Xerces cuando se abren documentos "normales" y XML simultáneamente. Si ejecuta un comando de análisis SAX con un documento abierto en modo de lectura-escritura, se muestra un mensaje de alerta y el análisis es imposible.

El cierre de un documento XML debe realizarse mediante el comando CLOSE DOCUMENT. Si se abrieran algunos elementos XML, se cerrarán automáticamente.

Acerca de caracteres finales de línea y gestión de BOM

Al generar documentos SAX, 4D utiliza los siguientes ajustes predeterminados para los caracteres de fin de línea y el uso de la máscara de orden de bytes (BOM):

• Caracteres CRLF en Windows y LF en macOS para los caracteres de fin de línea
• archivos escritos sin BOM.

Compatibilidad

In projects created with 4D versions up to 19.x, by default 4D uses CRLF as end-of-line characters on macOS for SAX and a BOM. You can control the XML line ending and XML BOM management using the XML SET OPTIONS command and a Compatibility setting. Important: Since SAX file lines are written directly at each statement, if you need to set the BOM and/or end-of-line options, you must call the XML SET OPTIONS command before the first SAX writing command.