Introdução aos comandos XML SAX

4D v16.3

Este tema agrupa os comandos XML SAX de 4D.

Para informação geral sobre XML (apresentação, conjunto de caracteres, glossário) assim como sobre as diferenças entre os modos DOM e SAX, consulte a seção Visão Geral dos comandos XML DOM.

Nota sobre comandos thread-seguros: referências XML criadas por um processo preemptivo só podem ser usadas naquele processo específico. Por outro lado, referências XML ciradas por um processo cooperativo podem ser usadas por qualquer outro processo cooperativo (mesmo comportamento que em versões anteriores) mas não podem ser usadas em qualquer processo preemptivo.

Criar, abrir e fechar documentos XML através de SAX

Os comandos SAX trabalham com as referencias de documentos padrão de 4D (DocRef, referencia de tipo Hora). Portanto é possível utilizar estes comandos de forma conjunta com os comandos 4D utilizados para administrar documentos, tais como SEND PACKET ou Append document.

A criação e abertura por programação de documentos XML são realizadas utilizando os comandos Create document e Open document. Posteriormente, o uso de um comando de um comando XML com estes documentos provocará a implementação automática dos mecanismos XML tais como a codificação. Por exemplo, o cabeçalho <?xml version="1.0" encoding="… encodage …" standalone = "não "?> se escreverá automaticamente no documento.

Nota: os documentos que vão ser lidos por comandos SAX devem ser abertos em modo apenas leitura pelo comando Open document. Isto evita conflitos entre 4D e a biblioteca Xerces ao abrir simultaneamente documentos “padrão” e documentos XML. Se executar um comando de análise SAX com um documento aberto em modo leitura escrita, se mostra uma mensagem de alerta e a análise é impossível.

O fechamento de um documento XML SAX deve ser realizado utilizando o comando CLOSE DOCUMENT. Se houver elementos XML abertos, serão fechados automaticamente.