org.codice.ddf.internal.country.converter.local

Class LocalCountryCodeConverter

java.lang.Object

org.codice.ddf.internal.country.converter.local.LocalCountryCodeConverter

All Implemented Interfaces:

CountryCodeConverter

public class LocalCountryCodeConverter
extends Object
implements CountryCodeConverter

Service to convert county codes into various formats by performing a local lookup. This works by loading in a static properties file containing the FIPS 10-4 to ISO 3166-1 alpha 3 country code mappings and builds multi maps of the mappings in order to perform the conversions. The country code mappings file is provided by default and can be configured if the country code mappings would ever change. For more information on how the country code mappings are formatted, refer to this feature's README file.

Constructor Summary

Constructors

Constructor and Description
LocalCountryCodeConverter()

Method Summary

Modifier and Type	Method and Description
List<String>	convertFipsToIso3(String fipsCountryCode) Converts FIPS 10-4 into ISO 3166-1 alpha 3.
List<String>	convertIso3ToFips(String iso3alphaCountryCode) Converts ISO 3166-1 alpha 3 into FIPS 10-4.
void	setCountryCodeMappingsFile(String countryCodeMappingFile)

Methods inherited from class java.lang.Object

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

Constructor Detail

LocalCountryCodeConverter

public LocalCountryCodeConverter()

Method Detail

convertFipsToIso3

public List<String> convertFipsToIso3(@Nullable
                                      String fipsCountryCode)

Description copied from interface: CountryCodeConverter

Converts FIPS 10-4 into ISO 3166-1 alpha 3. If a FIPS 10-4 code maps to more than one ISO 3166-1 alpha 3 code, all of them will be returned in a list of strings.

Specified by:

convertFipsToIso3 in interface CountryCodeConverter

Parameters:

fipsCountryCode - a FIPS 10-4 country code

Returns:

an ISO 3166-1 alpha-3 country code in a List or an empty list if there isn't a valid conversion.

convertIso3ToFips

public List<String> convertIso3ToFips(@Nullable
                                      String iso3alphaCountryCode)

Description copied from interface: CountryCodeConverter

Converts ISO 3166-1 alpha 3 into FIPS 10-4. If an ISO 3166-1 alpha 3 code maps to more than one FIPS 10-4 code, all of them will be returned in a list of strings.

Specified by:

convertIso3ToFips in interface CountryCodeConverter

Parameters:

iso3alphaCountryCode - an ISO 3166 alpha 3 country code

Returns:

an ISO 3166-1 country code in a List or an empty list if there isn't a valid conversion.

setCountryCodeMappingsFile

public void setCountryCodeMappingsFile(String countryCodeMappingFile)