ca.uhn.hl7v2.llp

Class LowerLayerProtocol

java.lang.Object

ca.uhn.hl7v2.llp.LowerLayerProtocol

Direct Known Subclasses:

ExtendedMinLowerLayerProtocol, MinLowerLayerProtocol

public abstract class LowerLayerProtocol
extends Object

Represents a particular "lower layer protocol" over which HL7 messages can be sent. An example is the "minimal lower layer protocol" defines in the HL7 implementation guide (appendix C) - this is implemented by the class MinLowerLayerProtocol. Implementations should call the static method logCharacterReceived() when a character is read from a remote system. This method may or may not log receipt, as configured (see docs for this method).

Author:

Bryan Tripp

Constructor Summary

Constructors

Constructor and Description
LowerLayerProtocol()

Method Summary

Methods

Modifier and Type	Method and Description
abstract HL7Reader	getReader(InputStream in) Returns an HL7Reader that implements message reading according to this protocol.
abstract HL7Writer	getWriter(OutputStream out) Returns an HL7Writer that implements message writing according to this protocol.
static void	logCharacterReceived(int c) Logs the fact that a character has been received, if configured to do so.
static LowerLayerProtocol	makeLLP() Deprecated. as there is now the choice between MinLowerLayerProtocol and ExtendedMinLowerLayerProtocol.

Methods inherited from class java.lang.Object

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

Constructor Detail

LowerLayerProtocol

public LowerLayerProtocol()

Method Detail

makeLLP

public static LowerLayerProtocol makeLLP()

Deprecated. as there is now the choice between MinLowerLayerProtocol and ExtendedMinLowerLayerProtocol.

Returns a particular implementation of LowerLayerProtocol.

getReader

public abstract HL7Reader getReader(InputStream in)
                             throws LLPException

Returns an HL7Reader that implements message reading according to this protocol.

Throws:

LLPException

getWriter

public abstract HL7Writer getWriter(OutputStream out)
                             throws LLPException

Returns an HL7Writer that implements message writing according to this protocol.

Throws:

LLPException

logCharacterReceived

public static void logCharacterReceived(int c)

Logs the fact that a character has been received, if configured to do so. This is a debugging feature. This is enabled by setting the system property ca.uhn.hl7v2.llp.logBytesRead=TRUE (before LowerLayerProtocol is instantiated). A message is logged for each character. THIS IS VERY SLOW and should normally be turned off.

Note that as of HAPI 1.3, this will be logged using commons-logging at a level of "info" instead of being printed to System.out