XmlWriter Classe

Pacote:

com.azure.xml

Artefato Maven:

com.azure:azure-xml:1.0.0-beta.2

• java.lang.Object
• • com.azure.xml.XmlWriter

Implementações

AutoCloseable

public abstract class XmlWriter
implements AutoCloseable

Grava um valor codificado em XML em um fluxo.

Resumo do Construtor

Construtor	Description
XmlWriter()	Cria uma instância de XmlWriter.

Resumo do método

Modificador e tipo	Método e descrição
abstract void	close() Fecha o fluxo XML.
abstract XmlWriter	flush() Libera qualquer conteúdo não liberado que tenha sido gravado no XmlWriter.
final XmlWriter	writeBinary(byte[] value) Grava um valor binário como uma cadeia de caracteres base64.
final XmlWriter	writeBinaryAttribute(String localName, byte[] value) Grava um atributo binário como uma cadeia de caracteres base64 (attribute="value").
final XmlWriter	writeBinaryAttribute(String namespaceUri, String localName, byte[] value) Grava um atributo binário como uma cadeia de caracteres base64 que tem um prefixo (prefix:attribute="value").
final XmlWriter	writeBinaryElement(String localName, byte[] value) Grava um elemento binário como uma cadeia de caracteres base64 (value).
final XmlWriter	writeBinaryElement(String namespaceUri, String localName, byte[] value) Grava um elemento binário como uma cadeia de caracteres base64 que tem um prefixo (value).
final XmlWriter	writeBoolean(boolean value) Grava um valor booliano.
final XmlWriter	writeBoolean(Boolean value) Grava um valor booliano anulável.
final XmlWriter	writeBooleanAttribute(String localName, boolean value) Grava um atributo booliano (attribute="true").
final XmlWriter	writeBooleanAttribute(String localName, Boolean value) Grava um atributo booliano anulável (attribute="false").
final XmlWriter	writeBooleanAttribute(String namespaceUri, String localName, boolean value) Grava um atributo booliano que tem um prefixo (prefix:attribute="true").
final XmlWriter	writeBooleanAttribute(String namespaceUri, String localName, Boolean value) Grava um atributo booliano anulável que tem um prefixo (prefix:attribute="false").
final XmlWriter	writeBooleanElement(String localName, boolean value) Grava um elemento booliano (true).
final XmlWriter	writeBooleanElement(String localName, Boolean value) Grava um elemento booliano anulável (true).
final XmlWriter	writeBooleanElement(String namespaceUri, String localName, boolean value) Grava um elemento booliano que tem um prefixo (true).
final XmlWriter	writeBooleanElement(String namespaceUri, String localName, Boolean value) Grava um elemento booliano anulável que tem um prefixo (true).
abstract XmlWriter	writeCDataString(String value) Grava um valor CData diretamente em um elemento XML (value).
final XmlWriter	writeDouble(double value) Grava um valor duplo.
final XmlWriter	writeDoubleAttribute(String localName, double value) Grava um atributo duplo (attribute="3.14").
final XmlWriter	writeDoubleAttribute(String namespaceUri, String localName, double value) Grava um atributo duplo que tem um prefixo (prefix:attribute="3.14").
final XmlWriter	writeDoubleElement(String localName, double value) Grava um elemento duplo (3.14).
final XmlWriter	writeDoubleElement(String namespaceUri, String localName, double value) Grava um elemento duplo que tem um prefixo (3.14).
abstract XmlWriter	writeEndElement() Encerra o elemento XML atual gravando a marca de fechamento ('').
final XmlWriter	writeFloat(float value) Grava um valor float.
final XmlWriter	writeFloatAttribute(String localName, float value) Grava um atributo float (attribute="2.7").
final XmlWriter	writeFloatAttribute(String namespaceUri, String localName, float value) Grava um atributo float que tem um prefixo (prefix:attribute="2.7").
final XmlWriter	writeFloatElement(String localName, float value) Grava um elemento float (2.7).
final XmlWriter	writeFloatElement(String namespaceUri, String localName, float value) Grava um elemento float que tem um prefixo (2.7).
final XmlWriter	writeInt(int value) Grava um valor int.
final XmlWriter	writeIntAttribute(String localName, int value) Grava um atributo int (attribute="10").
final XmlWriter	writeIntAttribute(String namespaceUri, String localName, int value) Grava um atributo int que tem um prefixo (prefix:attribute="10").
final XmlWriter	writeIntElement(String localName, int value) Grava um elemento int (10).
final XmlWriter	writeIntElement(String namespaceUri, String localName, int value) Grava um elemento int que tem um prefixo (10).
final XmlWriter	writeLong(long value) Grava um valor longo.
final XmlWriter	writeLongAttribute(String namespaceUri, String localName, long value) Grava um atributo longo que tem um prefixo (prefix:attribute="100000000000").
final XmlWriter	writeLongAttribute(String localName, long value) Grava um atributo longo (attribute="100000000000").
final XmlWriter	writeLongElement(String namespaceUri, String localName, long value) Grava um elemento longo que tem um prefixo (100000000000).
final XmlWriter	writeLongElement(String localName, long value) Grava um elemento long (100000000000).
abstract XmlWriter	writeNamespace(String namespaceUri) Grava um namespace XML padrão.
abstract XmlWriter	writeNamespace(String namespacePrefix, String namespaceUri) Grava um namespace XML com um prefixo especificado.
final XmlWriter	writeNumber(Number value) Grava um número anulável.
final XmlWriter	writeNumberAttribute(String localName, Number value) Grava um atributo numérico anulável (attribute="number").
final XmlWriter	writeNumberAttribute(String namespaceUri, String localName, Number value) Grava um atributo numérico anulável que tem um prefixo (prefix:attribute="number").
final XmlWriter	writeNumberElement(String localName, Number value) Grava um elemento numérico anulável (number).
final XmlWriter	writeNumberElement(String namespaceUri, String localName, Number value) Grava um elemento numérico anulável que tem um prefixo (number).
final XmlWriter	writeStartDocument() Grava o início do documento XML ('').
abstract XmlWriter	writeStartDocument(String version, String encoding) Grava o início do documento XML ('').
final XmlWriter	writeStartElement(String localName) Inicia um início de elemento XML ('').
abstract XmlWriter	writeStartElement(String namespaceUri, String localName) Inicia um início de elemento XML que tem um prefixo ('').
final XmlWriter	writeStartSelfClosingElement(String localName) Inicia um início de elemento XML que será de auto-fechamento ('').
abstract XmlWriter	writeStartSelfClosingElement(String namespaceUri, String localName) Inicia um início de elemento XML que tem um prefixo que será o auto-fechamento ('').
abstract XmlWriter	writeString(String value) Grava um valor diretamente em um elemento XML (value).
final XmlWriter	writeStringAttribute(String localName, String value) Grava um atributo String (attribute="value").
abstract XmlWriter	writeStringAttribute(String namespaceUri, String localName, String value) Grava um atributo String que tem um prefixo (prefix:attribute="value").
final XmlWriter	writeStringElement(String localName, String value) Grava um elemento de cadeia de caracteres (string).
final XmlWriter	writeStringElement(String namespaceUri, String localName, String value) Grava um elemento de cadeia de caracteres que tem um prefixo (string).
final XmlWriter	writeXml(XmlSerializable<?> value) Grava um XmlSerializable<T> objeto .
final XmlWriter	writeXml(XmlSerializable<?> value, String rootElementName) Grava um XmlSerializable<T> objeto .

Métodos herdados de java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Detalhes do construtor

XmlWriter

public XmlWriter()

Cria uma instância de XmlWriter.

Detalhes do método

close

public abstract void close()

Fecha o fluxo XML.

Durante o fechamento, a implementação de XmlWriter deve liberar qualquer conteúdo não liberado.

Throws:

XMLStreamException

- Se o repositório de conteúdo subjacente não for fechado.

flush

public abstract XmlWriter flush()

Libera qualquer conteúdo não liberado que tenha sido gravado no XmlWriter.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o conteúdo XML não liberado não puder ser liberado.

writeBinary

public final XmlWriter writeBinary(byte[] value)

Grava um valor binário como uma cadeia de caracteres base64.

Se o value for nulo, isso será uma operação não operada.

Parameters:

value - Valor binário a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o valor XML não puder ser gravado.

writeBinaryAttribute

public final XmlWriter writeBinaryAttribute(String localName, byte[] value)

Grava um atributo binário como uma cadeia de caracteres base64 (attribute="value").

Se o value for nulo, isso será uma operação não operada.

Parameters:

localName - Nome do atributo.

value - Valor binário a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeBinaryAttribute

public final XmlWriter writeBinaryAttribute(String namespaceUri, String localName, byte[] value)

Grava um atributo binário como uma cadeia de caracteres base64 que tem um prefixo (prefix:attribute="value").

Se o value for nulo, isso será uma operação não operada.

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se nulo o namespace padrão for usado.

localName - Nome do atributo.

value - Valor binário a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeBinaryElement

public final XmlWriter writeBinaryElement(String localName, byte[] value)

Grava um elemento binário como uma cadeia de caracteres base64 (value).

Se o value for nulo, isso será uma operação não operada.

Parameters:

localName - Nome do elemento.

value - Valor binário a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeBinaryElement

public final XmlWriter writeBinaryElement(String namespaceUri, String localName, byte[] value)

Grava um elemento binário como uma cadeia de caracteres base64 que tem um prefixo (value).

Se o value for nulo, isso será uma operação não operada.

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se nulo o namespace padrão for usado.

localName - Nome do elemento.

value - Valor binário a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeBoolean

public final XmlWriter writeBoolean(boolean value)

Grava um valor booliano.

Parameters:

value - valor booliano a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o valor XML não puder ser gravado.

writeBoolean

public final XmlWriter writeBoolean(Boolean value)

Grava um valor booliano anulável.

Se o value for nulo, isso será uma operação não operada.

Parameters:

value - Valor booliano a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o valor XML não puder ser gravado.

writeBooleanAttribute

public final XmlWriter writeBooleanAttribute(String localName, boolean value)

Grava um atributo booliano (attribute="true").

Parameters:

localName - Nome do atributo.

value - valor booliano a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeBooleanAttribute

public final XmlWriter writeBooleanAttribute(String localName, Boolean value)

Grava um atributo booliano anulável (attribute="false").

Se o value for nulo, isso será uma operação não operada.

Parameters:

localName - Nome do atributo.

value - Valor booliano a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeBooleanAttribute

public final XmlWriter writeBooleanAttribute(String namespaceUri, String localName, boolean value)

Grava um atributo booliano que tem um prefixo (prefix:attribute="true").

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se nulo o namespace padrão for usado.

localName - Nome do atributo.

value - valor booliano a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeBooleanAttribute

public final XmlWriter writeBooleanAttribute(String namespaceUri, String localName, Boolean value)

Grava um atributo booliano anulável que tem um prefixo (prefix:attribute="false").

Se o value for nulo, este será um no-op.

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se for nulo, o namespace padrão será usado.

localName - Nome do atributo.

value - Valor booliano a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeBooleanElement

public final XmlWriter writeBooleanElement(String localName, boolean value)

Grava um elemento booliano (true).

Parameters:

localName - Nome do elemento.

value - valor booliano a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeBooleanElement

public final XmlWriter writeBooleanElement(String localName, Boolean value)

Grava um elemento booliano anulável (true).

Se o value for nulo, este será um no-op.

Parameters:

localName - Nome do elemento.

value - Valor booliano a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeBooleanElement

public final XmlWriter writeBooleanElement(String namespaceUri, String localName, boolean value)

Grava um elemento booliano que tem um prefixo (true).

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se for nulo, o namespace padrão será usado.

localName - Nome do elemento.

value - valor booliano a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeBooleanElement

public final XmlWriter writeBooleanElement(String namespaceUri, String localName, Boolean value)

Grava um elemento booliano anulável que tem um prefixo (true).

Se o value for nulo, este será um no-op.

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se for nulo, o namespace padrão será usado.

localName - Nome do elemento.

value - Valor booliano a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeCDataString

public abstract XmlWriter writeCDataString(String value)

Grava um valor CData diretamente em um elemento XML (value).

Isso não grava a marca de início ou de término do elemento XML.

Essa API é uma conveniência writeString(String value) para valores CData, é possível usar writeString(String value) em vez dessa API.

Parameters:

value - Valor CData a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o valor de CData XML não puder ser gravado.

writeDouble

public final XmlWriter writeDouble(double value)

Grava um valor duplo.

Parameters:

value - valor duplo a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o valor XML não puder ser gravado.

writeDoubleAttribute

public final XmlWriter writeDoubleAttribute(String localName, double value)

Grava um atributo duplo (attribute="3.14").

Parameters:

localName - Nome do atributo.

value - valor duplo a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeDoubleAttribute

public final XmlWriter writeDoubleAttribute(String namespaceUri, String localName, double value)

Grava um atributo duplo que tem um prefixo (prefix:attribute="3.14").

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se for nulo, o namespace padrão será usado.

localName - Nome do atributo.

value - valor duplo a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeDoubleElement

public final XmlWriter writeDoubleElement(String localName, double value)

Grava um elemento duplo (3.14).

Parameters:

localName - Nome do elemento.

value - valor duplo a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeDoubleElement

public final XmlWriter writeDoubleElement(String namespaceUri, String localName, double value)

Grava um elemento duplo que tem um prefixo (3.14).

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se for nulo, o namespace padrão será usado.

localName - Nome do elemento.

value - valor duplo a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeEndElement

public abstract XmlWriter writeEndElement()

Encerra o elemento XML atual gravando a marca de fechamento ('').

Essa chamada determinará o nome e o prefixo da marca do elemento XML, se houver um, para fechar o escopo do elemento XML atual.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se a extremidade do elemento XML não puder ser gravada.

writeFloat

public final XmlWriter writeFloat(float value)

Grava um valor float.

Parameters:

value - valor float a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o valor XML não puder ser gravado.

writeFloatAttribute

public final XmlWriter writeFloatAttribute(String localName, float value)

Grava um atributo float (attribute="2.7").

Parameters:

localName - Nome do atributo.

value - valor float a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeFloatAttribute

public final XmlWriter writeFloatAttribute(String namespaceUri, String localName, float value)

Grava um atributo float que tem um prefixo (prefix:attribute="2.7").

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se for nulo, o namespace padrão será usado.

localName - Nome do atributo.

value - valor float a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeFloatElement

public final XmlWriter writeFloatElement(String localName, float value)

Grava um elemento float (2.7).

Parameters:

localName - Nome do elemento.

value - valor float a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeFloatElement

public final XmlWriter writeFloatElement(String namespaceUri, String localName, float value)

Grava um elemento float que tem um prefixo (2.7).

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se nulo o namespace padrão for usado.

localName - Nome do elemento.

value - valor float a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeInt

public final XmlWriter writeInt(int value)

Grava um valor int.

Parameters:

value - int value a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o valor XML não puder ser gravado.

writeIntAttribute

public final XmlWriter writeIntAttribute(String localName, int value)

Grava um atributo int (attribute="10").

Parameters:

localName - Nome do atributo.

value - int value a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeIntAttribute

public final XmlWriter writeIntAttribute(String namespaceUri, String localName, int value)

Grava um atributo int que tem um prefixo (prefix:attribute="10").

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se nulo o namespace padrão for usado.

localName - Nome do atributo.

value - int value a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeIntElement

public final XmlWriter writeIntElement(String localName, int value)

Grava um elemento int (10).

Parameters:

localName - Nome do elemento.

value - int value a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeIntElement

public final XmlWriter writeIntElement(String namespaceUri, String localName, int value)

Grava um elemento int que tem um prefixo (10).

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se nulo o namespace padrão for usado.

localName - Nome do elemento.

value - int value a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeLong

public final XmlWriter writeLong(long value)

Grava um valor longo.

Parameters:

value - valor longo a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o valor XML não puder ser gravado.

writeLongAttribute

public final XmlWriter writeLongAttribute(String namespaceUri, String localName, long value)

Grava um atributo longo que tem um prefixo (prefix:attribute="100000000000").

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se nulo o namespace padrão for usado.

localName - Nome do atributo.

value - valor longo a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeLongAttribute

public final XmlWriter writeLongAttribute(String localName, long value)

Grava um atributo longo (attribute="100000000000").

Parameters:

localName - Nome do atributo.

value - valor longo a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeLongElement

public final XmlWriter writeLongElement(String namespaceUri, String localName, long value)

Grava um elemento longo que tem um prefixo (100000000000).

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se nulo o namespace padrão for usado.

localName - Nome do elemento.

value - valor longo a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeLongElement

public final XmlWriter writeLongElement(String localName, long value)

Grava um elemento long (100000000000).

Parameters:

localName - Nome do elemento

value - valor longo a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeNamespace

public abstract XmlWriter writeNamespace(String namespaceUri)

Grava um namespace XML padrão.

Parameters:

namespaceUri - URI do namespace a ser associado como o namespace padrão.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o namespace XML não puder ser gravado.

writeNamespace

public abstract XmlWriter writeNamespace(String namespacePrefix, String namespaceUri)

Grava um namespace XML com um prefixo especificado.

Se o namespacePrefix for nulo ou xmlns chamar esse método será equivalente a writeNamespace(String namespaceUri).

Parameters:

namespacePrefix - Prefixo que o namespace associa.

namespaceUri - URI do namespace a ser associado ao prefixo.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o namespace XML não puder ser gravado.

writeNumber

public final XmlWriter writeNumber(Number value)

Grava um número anulável.

Se value for nulo, isso será uma operação não operada.

Parameters:

value - Valor numérico a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o valor XML não puder ser gravado.

writeNumberAttribute

public final XmlWriter writeNumberAttribute(String localName, Number value)

Grava um atributo numérico anulável (attribute="number").

Parameters:

localName - Nome do atributo.

value - Valor numérico a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeNumberAttribute

public final XmlWriter writeNumberAttribute(String namespaceUri, String localName, Number value)

Grava um atributo numérico anulável que tem um prefixo (prefix:attribute="number").

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se for nulo, o namespace padrão será usado.

localName - Nome do atributo.

value - Valor numérico a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeNumberElement

public final XmlWriter writeNumberElement(String localName, Number value)

Grava um elemento numérico anulável (number).

Se o value for nulo, este será um no-op.

Parameters:

localName - Nome do elemento.

value - Valor numérico a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeNumberElement

public final XmlWriter writeNumberElement(String namespaceUri, String localName, Number value)

Grava um elemento numérico anulável que tem um prefixo (number).

Se o value for nulo, este será um no-op.

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se for nulo, o namespace padrão será usado.

localName - Nome do elemento.

value - Valor numérico a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeStartDocument

public final XmlWriter writeStartDocument()

Grava o início do documento XML ('').

Isso usa a versão e a codificação padrão que são 1.0 e utf-8 respectivamente. Se uma versão ou codificação diferente for necessária, use writeStartDocument(String version, String encoding) o que permite especificar esses valores.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o documento inicial XML não puder ser gravado.

writeStartDocument

public abstract XmlWriter writeStartDocument(String version, String encoding)

Grava o início do documento XML ('').

encoding E version são opcionais e, se não forem passados, seus valores padrão serão usados. Para version o padrão é 1.0 e para encoding o padrão é utf-8.

Parameters:

version - Versão do documento XML.

encoding - Codificação de documento XML.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o documento inicial XML não puder ser gravado.

writeStartElement

public final XmlWriter writeStartElement(String localName)

Inicia um início de elemento XML ('').

Essa chamada não fecha (>) o elemento XML é iniciado, mas, em vez disso, o adia até que uma chamada inicie outro elemento ou para gravar o corpo do elemento. Isso também requer uma chamada explícita para writeEndElement() para encerrar o corpo do elemento XML.

As chamadas para gravar atributos não fecharão o elemento XML.

Parameters:

localName - Nome do elemento.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o início do elemento XML não puder ser gravado.

writeStartElement

public abstract XmlWriter writeStartElement(String namespaceUri, String localName)

Inicia um início de elemento XML que tem um prefixo ('').

Essa chamada não fecha (>) o elemento XML é iniciado, mas, em vez disso, o adia até que uma chamada inicie outro elemento ou para gravar o corpo do elemento. Isso também requer uma chamada explícita para writeEndElement() para encerrar o corpo do elemento XML.

As chamadas para gravar atributos não fecharão o elemento XML.

Se prefix for nulo, isso se comportará da mesma forma que writeStartElement(String localName).

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se for nulo, o namespace padrão será usado.

localName - Nome do elemento.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o início do elemento XML não puder ser gravado.

writeStartSelfClosingElement

public final XmlWriter writeStartSelfClosingElement(String localName)

Inicia um início de elemento XML que será de auto-fechamento ('').

Essa chamada não fecha (/>) o início do elemento XML, mas o adia até que uma chamada inicie outro elemento. Se houver uma tentativa de gravar o corpo do elemento depois de iniciar um elemento de auto-fechamento, um IllegalStateException será lançado, pois os elementos de auto-fechamento não têm um corpo.

As chamadas para gravar atributos não fecharão o elemento XML.

Parameters:

localName - Nome do elemento.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o início do elemento XML não puder ser gravado.

writeStartSelfClosingElement

public abstract XmlWriter writeStartSelfClosingElement(String namespaceUri, String localName)

Inicia um início de elemento XML que tem um prefixo que será o auto-fechamento ('').

Essa chamada não fecha (/>) o início do elemento XML, mas o adia até que uma chamada inicie outro elemento. Se houver uma tentativa de gravar o corpo do elemento depois de iniciar um elemento de auto-fechamento, um IllegalStateException será lançado, pois os elementos de auto-fechamento não têm um corpo.

As chamadas para gravar atributos não fecharão o elemento XML.

Se prefix for nulo, isso se comportará da mesma forma que writeStartSelfClosingElement(String localName).

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se for nulo, o namespace padrão será usado.

localName - Nome do elemento.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o início do elemento XML não puder ser gravado.

writeString

public abstract XmlWriter writeString(String value)

Grava um valor diretamente em um elemento XML (value).

Isso não grava a marca de início ou de término do elemento XML.

writeCDataString(String value) será uma API de conveniência se um valor de CData XML precisar ser gravado.

Parameters:

value - Valor a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o valor XML não puder ser gravado.

writeStringAttribute

public final XmlWriter writeStringAttribute(String localName, String value)

Grava um atributo String (attribute="value").

Parameters:

localName - Nome do atributo.

value - Valor do atributo.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeStringAttribute

public abstract XmlWriter writeStringAttribute(String namespaceUri, String localName, String value)

Grava um atributo String que tem um prefixo (prefix:attribute="value").

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se for nulo, o namespace padrão será usado.

localName - Nome do atributo.

value - Valor do atributo.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o atributo XML não puder ser gravado.

writeStringElement

public final XmlWriter writeStringElement(String localName, String value)

Grava um elemento de cadeia de caracteres (string).

Se o value for nulo, este será um no-op.

Parameters:

localName - Nome do elemento.

value - Valor da cadeia de caracteres a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeStringElement

public final XmlWriter writeStringElement(String namespaceUri, String localName, String value)

Grava um elemento de cadeia de caracteres que tem um prefixo (string).

Se o value for nulo, este será um no-op.

Parameters:

namespaceUri - URI do namespace ao qual associar o prefixo, se for nulo, o namespace padrão será usado.

localName - Nome do elemento.

value - Valor da cadeia de caracteres a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o elemento XML e o valor não puderem ser gravados.

writeXml

public final XmlWriter writeXml(XmlSerializable value)

Grava um XmlSerializable<T> objeto .

Se o value for nulo, este será um no-op.

Parameters:

value - Objeto XmlSerializable<T> a ser gravado.

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o objeto XML não puder ser gravado.

writeXml

public final XmlWriter writeXml(XmlSerializable value, String rootElementName)

Grava um XmlSerializable<T> objeto .

Se o value for nulo, este será um no-op.

Se rootElementName for nulo, isso será o mesmo que chamar writeXml(XmlSerializable<?> value).

Parameters:

value - Objeto XmlSerializable<T> a ser gravado.

rootElementName - Substituição do nome do elemento XML definido pelo objeto .

Returns:

O objeto XmlWriter atualizado.

Throws:

XMLStreamException

- Se o objeto XML não puder ser gravado.