VistALink v1.6

gov.va.med.vistalink.institution
Interface IPrimaryStationRules


public interface IPrimaryStationRules

Interface for PrimaryStationRules implementations. All implementations must be threadsafe.


Method Summary
 java.lang.String getPrimaryStationLookupString(java.lang.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(java.lang.String primaryStation)
          Implement a method that validates a particular 'primary station' identifier string as valid.
 

Method Detail

validatePrimaryStation

void validatePrimaryStation(java.lang.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

java.lang.String getPrimaryStationLookupString(java.lang.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.

VistALink v1.6

VistALink v1.6