Package org.dellroad.hl7.llp

Interface CharsetDecoder

All Known Implementing Classes:

MSH18CharsetDecoder

public interface CharsetDecoder

Strategy interface for determining the character encoding to use when reading and writing HL7 messages.

Method Summary

Modifier and Type	Method	Description
Charset	charsetForIncomingMessage(byte[] buf, int offset, int length)	Determine the character encoding to use for an incoming HL7 message.
Charset	charsetForOutgoingMessage(HL7Message msg)	Determine the character encoding to use for an outgoing HL7 message.
static CharsetDecoder	fixed(Charset charset)	Create a CharsetDecoder that always returns the given Charset.

Method Detail

charsetForIncomingMessage

Charset charsetForIncomingMessage(byte[] buf,
                                  int offset,
                                  int length)

Determine the character encoding to use for an incoming HL7 message.

Parameters:

buf - raw HL7 message buffer

offset - HL7 message offset in buf

length - HL7 message length in buf

Returns:

character encoding to use for the given message (never null)

Throws:

IllegalArgumentException - if buf is null

ArrayIndexOutOfBoundsException - if offset and/or length are invalid

charsetForOutgoingMessage

Charset charsetForOutgoingMessage(HL7Message msg)

Determine the character encoding to use for an outgoing HL7 message.

Parameters:

msg - HL7 message

Returns:

character encoding to use for the given message (never null)

Throws:

IllegalArgumentException - if msg is null

fixed

static CharsetDecoder fixed(Charset charset)

Create a CharsetDecoder that always returns the given Charset.

Parameters:

charset - character encoding to use

Returns:

a fixed-answer CharsetDecoder

Throws:

IllegalArgumentException - if charset is null