ca.uhn.hl7v2.util

Class ReadOnlyMessageIterator

java.lang.Object

ca.uhn.hl7v2.util.ReadOnlyMessageIterator

All Implemented Interfaces:

Iterator<Structure>

public class ReadOnlyMessageIterator
extends Object
implements Iterator<Structure>

Iterator though existing Stuctures in a message. No new repetitions or optional structures are created during iteration (in contrast to MessageIterator). Note that some structures are created during parsing, so the iteration may include structures which were not present in the original encoded message. If these are not desired they can be skipped using a FilterIterator. In fact to obtain an iterator only over populated segments (not groups or empty segments) use the factory method in this class.

Version:

$Revision: 1.1 $ updated on $Date: 2007-02-19 02:24:27 $ by $Author: jamesagnew $

Author:

Bryan Tripp

Constructor Summary

Constructors

Constructor and Description
ReadOnlyMessageIterator(Group theRoot)

Method Summary

Methods

Modifier and Type	Method and Description
static Iterator<Structure>	createPopulatedSegmentIterator(Group theRoot)
static Iterator<Structure>	createPopulatedStructureIterator(Group theRoot, Class<? extends Structure> c)
static Iterator<Structure>	createPopulatedStructureIterator(Group theRoot, FilterIterator.Predicate<Structure> structureFilter)
static Iterator<Structure>	createPopulatedStructureIterator(Group theRoot, String structureName)
boolean	hasNext()
Structure	next()
void	remove() Not supported.

Methods inherited from class java.lang.Object

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

Constructor Detail

ReadOnlyMessageIterator

public ReadOnlyMessageIterator(Group theRoot)

Parameters:

theRoot - root of depth first iteration, which starts with the first child

Method Detail

createPopulatedSegmentIterator

public static Iterator<Structure> createPopulatedSegmentIterator(Group theRoot)

Parameters:

theRoot - root of depth first iteration, which starts with the first child

Returns:

an iterator that skips groups and empty segments, returning only populated segments

createPopulatedStructureIterator

public static Iterator<Structure> createPopulatedStructureIterator(Group theRoot,
                                                   Class<? extends Structure> c)

Parameters:

theRoot - root of depth first iteration, which starts with the first child

c - structure class to look for

Returns:

an iterator that skips all structures that do not match the parameter

createPopulatedStructureIterator

public static Iterator<Structure> createPopulatedStructureIterator(Group theRoot,
                                                   String structureName)

Parameters:

theRoot - root of depth first iteration, which starts with the first child

structureName - structure name to look for

Returns:

an iterator that skips all structures that do not match the parameter

createPopulatedStructureIterator

public static Iterator<Structure> createPopulatedStructureIterator(Group theRoot,
                                                   FilterIterator.Predicate<Structure> structureFilter)

Parameters:

theRoot - root of depth first iteration, which starts with the first child

structureFilter - filter class

Returns:

iterator that skips all structures that the filter does not accept

hasNext

public boolean hasNext()

Specified by:

hasNext in interface Iterator<Structure>

See Also:

Iterator.hasNext()

next

public Structure next()

Specified by:

next in interface Iterator<Structure>

See Also:

Iterator.next()

remove

public void remove()

Not supported.

Specified by:

remove in interface Iterator<Structure>