001package org.kuali.coeus.common.api.country;
002
003
004public interface KcCountryService {
005
006    /**
007     * This method retrieves a country by country code.  If the country is not found null is returned.
008     * The country code cannot be blank.
009     *
010     * @param code the country code.  cannot be blank.
011     * @return the country or null if not found.
012     * @throws java.lang.IllegalArgumentException if the code is blank
013     */
014    CountryContract getCountry(String code);
015
016    /**
017     * This method retrieves a country by alternate country code.  The alternate country code is usually a three digit
018     * code. If the country is not found null is returned. The alternate country code cannot be blank.
019     *
020     * @param alternateCode the alternate country code.  cannot be blank.
021     * @return the country or null if not found.
022     * @throws java.lang.IllegalArgumentException if the alternateCode is blank
023     */
024    CountryContract getCountryByAlternateCode(String alternateCode);
025}