gov.va.med.vistalink.institution

Interface IPrimaryStationRules

All Known Implementing Classes:

PrimaryStationRulesVHA

public interface IPrimaryStationRules

Interface for PrimaryStationRules implementations. All implementations must be threadsafe.

Method Summary

Modifier and Type	Method and Description
String	getPrimaryStationLookupString(String division) Implement a method that, given a particular 'division' string (i.e., primary station plus optional division suffix), returns the primary Station derived from that division string.
void	validatePrimaryStation(String primaryStation) Implement a method that validates a particular 'primary station' identifier string as valid.

Method Detail

validatePrimaryStation

void validatePrimaryStation(String primaryStation)
                     throws InstitutionMappingBadStationNumberException

Implement a method that validates a particular 'primary station' identifier string as valid. Primary stations are used in VistALink to look up a connector. Therefore, the format of a valid 'primary station' identifier should be such that the entity or system it identifies would have one and only one connector associated with it.

Parameters:

primaryStation - identifier for a 'primary station', i.e., 'computing facility'

Throws:

InstitutionMappingBadStationNumberException - thrown if primaryStation param is considered an invalid identifier

getPrimaryStationLookupString

String getPrimaryStationLookupString(String division)
                              throws InstitutionMappingBadStationNumberException

Implement a method that, given a particular 'division' string (i.e., primary station plus optional division suffix), returns the primary Station derived from that division string. The primary station is used for looking up connectors, and would be the 'computing facility' for the division in question.

Parameters:

division -

Returns:

the primaryStation value derived from the division parameter, to use for connector lookups.

Throws:

InstitutionMappingBadStationNumberException - thrown if the division passed in is considered invalid.