org.kuali.rice.shareddata.api.county
Interface CountyService

public interface CountyService

Method Summary

List<County>	findAllCountiesInCountryAndState(String countryCode, String stateCode) Gets all the County for postal country code & postal state code.
County	getCounty(String countryCode, String stateCode, String code) Gets a County from a postal country code and postal code value.

Method Detail

getCounty

County getCounty(String countryCode,
                 String stateCode,
                 String code)
                 throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException

Gets a County from a postal country code and postal code value.

This method will return null if the state does not exist.

This method will return active or inactive counties.

Parameters:

countryCode - country code. cannot be blank.

stateCode - postal state code. cannot be blank.

code - county code. cannot be blank

Returns:

a County or null

Throws:

IllegalArgumentException - country code, postal state code, or county code is blank

org.kuali.rice.core.api.exception.RiceIllegalArgumentException

findAllCountiesInCountryAndState

List<County> findAllCountiesInCountryAndState(String countryCode,
                                              String stateCode)
                                              throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException

Gets all the County for postal country code & postal state code.

This method will always return an immutable Collection even when no values exist.

This method will only return active counties.

Parameters:

countryCode - state code. cannot be blank.

stateCode - postal state code. cannot be blank.

Returns:

an immutable collection of counties

Throws:

IllegalArgumentException - country code, postal state code is blank

org.kuali.rice.core.api.exception.RiceIllegalArgumentException