public interface XMLConversionInterface
O DTD de origem ou de destino de uma conversão pode ser null,
indicando neste caso que o documento de origem ou de destino não possui a
declaração DOCTYPE.
OBS.: embora seja válido que o DTD de destino seja null,
esta é uma situação pouco comum (provavelmente inválida), e deve ser aplicada
com cuidado.
Conversões XML são usadas tipicamente quando o DTD usado por uma aplicação foi alterado e a aplicação deve ser capaz de ler arquivos gerados para versões anteriores do DTD.
XMLConverter| Modifier and Type | Method and Description |
|---|---|
boolean |
canConvertFrom(String dtd)
Indica se o conversor trata arquivos correspondentes a um DTD específico.
|
boolean |
canConvertFrom(XMLConversionInterface conversion)
Indica se a conversão é capaz de processar arquivos gerados por outra
conversão.
|
ConversionDocument |
convert()
Executa a conversão.
|
ConversionDocument |
convert(ConversionDocument doc)
Converte um documento.
|
ConversionDocument |
convert(File file,
boolean validate)
Converte um documento representado por um arquivo.
|
ConversionDocument |
convert(XMLConversionInterface previousConversion)
Converte a saída de uma outra conversão (para ser usado em
pipelines).
|
boolean |
convertsTo(String dtd)
Indica se o resultado da conversão corresponde a um DTD.
|
ConversionDocument |
getDocument() |
String |
getTargetDTD()
Indica que tipos de arquivo este conversor gera.
|
void |
setDocument(ConversionDocument doc)
Define o documento a ser convertido.
|
void |
writeXML(File file)
Escreve o documento em um arquivo.
|
void |
writeXML(OutputStream outStream)
Escreve o documento em um
OutputStream. |
void |
writeXML(String fileName)
Escreve o documento em um arquivo.
|
void |
writeXML(Writer writer)
Escreve o documento em um
Writer. |
void writeXML(OutputStream outStream) throws XMLConversionException
OutputStream. O documento não
necessariamente foi convertido.outStream - - stream de saídaXMLConversionException - se a entrada não foi definidavoid writeXML(Writer writer) throws XMLConversionException
Writer. O documento não
necessariamente foi convertido.writer - - Writer de saídaXMLConversionException - se a entrada não foi definidavoid writeXML(String fileName) throws XMLConversionException
fileName - - nome do arquivo de saídaXMLConversionException - se o arquivo é inválido, se a entrada não
foi definida ou se houve algum problema na gravaçãovoid writeXML(File file) throws XMLConversionException
file - - arquivo de saídaXMLConversionException - se o arquivo é inválido, se a entrada não
foi definida ou se houve algum problema na gravaçãoboolean canConvertFrom(String dtd)
dtd - - DTD a ser comparado com o tratado pelo conversor. Pode ser
nulo, sugerindo que o documento de origem não possui a declaração
DOCTYPEboolean canConvertFrom(XMLConversionInterface conversion)
conversion - - conversão anteriorboolean convertsTo(String dtd)
dtd - - o DTD a ser comparadoString getTargetDTD()
ConversionDocument convert(ConversionDocument doc) throws XMLConversionException
doc - - documento a ser convertidoXMLConversionException - se:
ConversionDocument convert(File file, boolean validate) throws XMLConversionException
file - - arquivo com o conteúdo a ser convertidovalidate - - indica se o documento deve ser validado pelo seu DTDXMLConversionException - se:
ConversionDocument convert(XMLConversionInterface previousConversion) throws XMLConversionException
previousConversion - - conversão recém-aplicadaXMLConversionException - se:
ConversionDocument convert() throws XMLConversionException
IMPORTANTE: a implementação deste método deve se certificar de que o estado do conversor está coerente (p.ex. a entrada de dados foi definida).
XMLConversionException - se:
ConversionDocument getDocument()
void setDocument(ConversionDocument doc)
doc - documento a ser convertidoCopyright © 2016 Tecgraf/PUC-Rio. All rights reserved.