Os elementos vazios e os valores nulos ocorrem frequentemente nos documentos XML.
Um fluxo de mensagens robusto deve ser capaz de reconhecer e manipular elementos vazios e valores nulos. De maneira semelhante, os elementos em uma árvore de mensagens podem ter um valor NULL, um valor vazio ou nenhum valor. Este tópico explica a análise e a gravação desses valores pelo domínio XMLNSC. Para obter conselho sobre boas práticas de codificação ESQL ou Java™, consulte Manipulando valores nulos.
| Descrição | Entrada XML analisada por XMLNSC | Valor de 'elemento' na árvore de mensagens |
|---|---|---|
| Valor de elemento vazio | <element/> | Cadeia vazia |
| Valor de elemento vazio | <element></element> | Cadeia vazia |
| Pasta com elementos-filhos | <element><childElement/></element> | Nenhum valor |
| Valor de Elemento Nil | <element xsi:nil="true"/> | Cadeia Vazia ou NULL Nota: Qual valor depende de a definição do elemento
ser 'anulável' no Esquema XML
|
Observe que ambas as formas de elemento vazio resultam no mesmo valor na árvore de mensagens.
| Descrição | Valor de ‘element' na árvore de mensagens | Saída XML do Analisador XMLNSC |
|---|---|---|
| Valor de elemento vazio | Cadeia vazia | <element/> |
| Valor de elemento nulo | NULL | <element/> |
| Pasta com elementos-filhos | Nenhum valor | <element><childElement/></element> |
- <element/>
- <element></element>
O analisador XMLNSC trata das duas formas da mesma maneira. O elemento é incluído na árvore de mensagens com um valor "" (a cadeia vazia).
Quando uma árvore de mensagens é produzida pelo analisador XMLNSC, ele sempre usa a primeira forma para os elementos que possuem um valor “” (a cadeia vazia).
O seguinte comportamento fica disponível apenas quando a validação estiver ativada no fluxo de mensagens.
Se um elemento no documento de entrada tiver um atributo xsi:nil com o valor ‘true' e a propriedade ‘nillable' da definição do elemento no esquema XML for configurada como ‘true', o analisador XMLNSC configura o valor do elemento da árvore de mensagens como NULL.
Quando uma árvore de mensagens é produzida pelo analisador XMLNSC, se o valor do elemento for NULL e o elemento não tiver elementos filhos, o elemento será gravado como <element/>; mas, se o elemento tiver um atributo xsi:nil, ele será gravado exatamente como qualquer outro atributo.
Observe que o analisador XMLNSC produz apenas atributos xsi:nil que já estão prontos na árvore de mensagens. Ele não produz automaticamente atributos xsi:nil para todos os elementos da árvore de mensagens que possuem um valor NULL e são 'nillable'.