ca.uhn.hl7v2.model
Interface Segment

All Superinterfaces:

java.io.Serializable, Structure

All Known Implementing Classes:

AbstractSegment, GenericSegment

public interface Segment
extends Structure

Represents an HL7 message segment, which is a unit of data that contains multiple fields.

Author:

Bryan Tripp (bryan_tripp@sourceforge.net)

Method Summary

Type[]	getField(int number) Returns the array of Fields at the specified index.
Type	getField(int number, int rep) Returns a specific repetition of field at the specified index.
int	getLength(int number) Returns the maximum length of the field at the given index, in characters.
int	getMaxCardinality(int number) Returns the maximum number of repetitions of this field that are allowed.
boolean	isRequired(int number) Returns true if the field at the given index is required, false otherwise.
int	numFields() Returns the number of fields defined by this segment (repeating fields are not counted multiple times).

Methods inherited from interface ca.uhn.hl7v2.model.Structure

getMessage, getName, getParent

Method Detail

getField

Type[] getField(int number)
                throws HL7Exception

Returns the array of Fields at the specified index. The array will be of length 1 for non-repeating fields, and >1 for repeating fields. Fields are numbered from 1.

Throws:

HL7Exception - if field index is out of range.

getField

Type getField(int number,
              int rep)
              throws HL7Exception

Returns a specific repetition of field at the specified index. If there exist fewer repetitions than are required, the number of repetitions can be increased by specifying the lowest repetition that does not yet exist. For example if there are two repetitions but three are needed, the third can be created and accessed using the following code:
Type t = getField(x, 2);

Parameters:

number - the field number

rep - the repetition number (starting at 0)

Throws:

HL7Exception - if field index is out of range, or if the specified repetition is more than 1 greater than the highest index of existing repetitions. NOTE: to facilitate local extensions, no exception is thrown if rep > max cardinality

isRequired

boolean isRequired(int number)
                   throws HL7Exception

Returns true if the field at the given index is required, false otherwise.

Throws:

HL7Exception - if field index is out of range.

getLength

int getLength(int number)
              throws HL7Exception

Returns the maximum length of the field at the given index, in characters.

Throws:

HL7Exception - if field index is out of range.

getMaxCardinality

int getMaxCardinality(int number)
                      throws HL7Exception

Returns the maximum number of repetitions of this field that are allowed. The current cardinality can be obtained by checking the length of the array returned by getLength(n).

Throws:

HL7Exception - if field index is out of range.

numFields

int numFields()

Returns the number of fields defined by this segment (repeating fields are not counted multiple times).