org.dellroad.hl7

Class XMLConverter

java.lang.Object

org.dellroad.hl7.XMLConverter

public final class XMLConverter
extends Object

Converts HL7Messages to and from XML.

Field Summary

Fields

Modifier and Type	Field and Description
static String	HL7_NAMESPACE_URI HL7 message XML namespace.
static String	HL7_TAG XML tag name used by toXML(org.dellroad.hl7.HL7Message, boolean).
static String	MESSAGE_TAG XML tag name used for one XML-encoded message.

Method Summary

Modifier and Type	Method and Description
static void	appendMessage(Node parent, HL7Message message, boolean omitEmpty) Convert a message to XML and append it to the given element.
static void	appendMessage(XMLStreamWriter writer, HL7Message message, boolean omitEmpty) Convert a message to XML and append it to the given XMLStreamWriter.
static void	appendSegment(Node parent, HL7Segment segment, boolean omitEmpty) Convert a segment to XML and append it to the given element.
static void	appendSegment(XMLStreamWriter writer, HL7Segment segment, boolean omitEmpty) Convert a segment to XML and write it to the given XMLStreamWriter.
static Document	createDocument() Create an empty XML document for HL7 messages.
static void	main(String[] args) Test routine.
static void	stream(Document doc, OutputStream out) Serialize the XML document and write it to the given output.
static void	stream(TransformerFactory transformerFactory, Document doc, OutputStream out) Serialize the XML document and write it to the given output.
static Document	toXML(HL7Message message, boolean omitEmpty) Convert an HL7 message message to an XML document.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

HL7_NAMESPACE_URI

public static final String HL7_NAMESPACE_URI

HL7 message XML namespace.

HL7_TAG

public static final String HL7_TAG

XML tag name used by toXML(org.dellroad.hl7.HL7Message, boolean).

See Also:

Constant Field Values

MESSAGE_TAG

public static final String MESSAGE_TAG

XML tag name used for one XML-encoded message.

See Also:

Constant Field Values

Method Detail

createDocument

public static Document createDocument()

Create an empty XML document for HL7 messages.

Returns:

empty document

toXML

public static Document toXML(HL7Message message,
                             boolean omitEmpty)

Convert an HL7 message message to an XML document. The document element will be <HL7> and contain one child which is the XML encoding of the message.

Parameters:

message - HL7 message

omitEmpty - Omit empty tags (other than the last one)

Returns:

HL7 message encoded as an XML document

appendMessage

public static void appendMessage(Node parent,
                                 HL7Message message,
                                 boolean omitEmpty)

Convert a message to XML and append it to the given element.

Parameters:

parent - an XML Element or Document node

message - HL7 message to append

omitEmpty - Omit empty tags (other than the last one)

appendMessage

public static void appendMessage(XMLStreamWriter writer,
                                 HL7Message message,
                                 boolean omitEmpty)
                          throws XMLStreamException

Convert a message to XML and append it to the given XMLStreamWriter.

Parameters:

writer - XML output

message - HL7 message to append

omitEmpty - Omit empty tags (other than the last one)

Throws:

XMLStreamException - if an XML error occurs

appendSegment

public static void appendSegment(Node parent,
                                 HL7Segment segment,
                                 boolean omitEmpty)

Convert a segment to XML and append it to the given element.

Parameters:

parent - an XML Element or Document node

segment - HL7 segment to append

omitEmpty - Omit empty tags (other than the last one)

appendSegment

public static void appendSegment(XMLStreamWriter writer,
                                 HL7Segment segment,
                                 boolean omitEmpty)
                          throws XMLStreamException

Convert a segment to XML and write it to the given XMLStreamWriter.

Parameters:

writer - XML output

segment - HL7 segment to append

omitEmpty - Omit empty tags (other than the last one)

Throws:

XMLStreamException - if an XML error occurs

stream

public static void stream(Document doc,
                          OutputStream out)
                   throws IOException

Serialize the XML document and write it to the given output.

Parameters:

doc - XML document to output

out - output desination

Throws:

IOException - if an I/O error occurs

stream

public static void stream(TransformerFactory transformerFactory,
                          Document doc,
                          OutputStream out)
                   throws IOException

Serialize the XML document and write it to the given output.

Parameters:

transformerFactory - factory for XSL transformers

doc - XML document to output

out - output desination

Throws:

IOException - if an I/O error occurs

main

public static void main(String[] args)
                 throws Exception

Test routine. Reads HL7 messages in "file format" and outputs them in an XML document.

Parameters:

args - command line arguments

Throws:

Exception - if an error occurs