org.kuali.rice.kns.service
Interface CountyService

All Known Implementing Classes:

CountyServiceImpl

public interface CountyService

Method Summary

County	getByPrimaryId(String postalStateCode, String countyCode) get a county object based on the given county code, state code and default country code.
County	getByPrimaryId(String postalCountryCode, String postalStateCode, String countyCode) get a county object based on the given county code, state code and country code.
County	getByPrimaryIdIfNecessary(String postalStateCode, String countyCode, County existingCounty) get a county object based on the given county code, state code and default country code.
County	getByPrimaryIdIfNecessary(String postalCountryCode, String postalStateCode, String countyCode, County existingCounty) get a county object based on the given county code, state code and default country code.

Method Detail

getByPrimaryId

County getByPrimaryId(String postalStateCode,
                      String countyCode)

get a county object based on the given county code, state code and default country code. The default country code is set up in the system.

Parameters:

postalStateCode - the given state code

countyCode - the given state code

Returns:

a county object based on the given county code, state code and default country code

getByPrimaryId

County getByPrimaryId(String postalCountryCode,
                      String postalStateCode,
                      String countyCode)

get a county object based on the given county code, state code and country code.

Parameters:

postalCountryCode - the given country code

postalStateCode - the given state code

countyCode - the given state code

Returns:

a county object based on the given county code, state code and country code

getByPrimaryIdIfNecessary

County getByPrimaryIdIfNecessary(String postalStateCode,
                                 String countyCode,
                                 County existingCounty)

get a county object based on the given county code, state code and default country code. The default country code is set up in the system. If the given postal state code and county code are same as those of the given existing county, return the existing county; otherwise, retrieve a county object.

Parameters:

postalStateCode - the given state code

countyCode - the given state code

existingCounty - the given existing county

Returns:

a county object based on the given county code, state code and default country code if necessary

getByPrimaryIdIfNecessary

County getByPrimaryIdIfNecessary(String postalCountryCode,
                                 String postalStateCode,
                                 String countyCode,
                                 County existingCounty)

get a county object based on the given county code, state code and default country code. The default country code is set up in the system. If the given postal country code, state code and county code are same as those of the given existing county, return the existing county; otherwise, retrieve a county object.

Parameters:

postalCountryCode - the given country code

postalStateCode - the given state code

countyCode - the given state code

existingCounty - the given existing county

Returns:

a county object based on the given county code, state code and country code if necessary