com.github.dannil.scbjavaclient.client

Class AbstractClient

java.lang.Object

com.github.dannil.scbjavaclient.client.AbstractClient

Direct Known Subclasses:

AbstractContainerClient, EnergyAnnualStatisticsClient, EnergyMonthlyStatisticsClient, EnvironmentIndustrialWaterUseClient, EnvironmentLandAndWaterAreaClient, EnvironmentLandUseBuildingsClient, EnvironmentLandUsePlanningClient, EnvironmentLandUseUsageClient, EnvironmentPackagingAndPackagingWasteClient, EnvironmentWasteClient, FinancialMarketsInstitutionsClient, FinancialMarketsInvestmentFundsClient, FinancialMarketsSecuritiesClient, FinancialMarketsShareholdersClient, LivingConditionsFamiliesAdoptionsClient, LivingConditionsFamiliesHousingClient, LivingConditionsFamiliesLegalGuardiansClient, LivingConditionsFamiliesSiblingsClient, PopulationAmountClient, PopulationAverageAgeClient, PopulationDemographyClient, PopulationDensityClient, PopulationLiveBirthsClient, PopulationNameStatisticsClient, PopulationPartnershipClient

public abstract class AbstractClient
extends Object

Abstract class which specifies how clients should operate.

Since:

0.0.2

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractClient() Default constructor.
protected	AbstractClient(Locale locale) Overloaded constructor.

Method Summary

Modifier and Type	Method and Description
protected String	doGetRequest(String url) Performs a GET request to the specified URL.
protected String	doPostRequest(String url, String query) Performs a POST request to the specified URL.
Locale	getLocale() Retrieves the Locale for this client instance.
Locale	getLocalizationLocale() Returns the Locale used for the localization.
protected String	getRootUrl() Determines the URL for the API based on the current Locale.
abstract String	getUrl() Returns the URL endpoint which this client represents.
void	setLocale(Locale locale) Sets the Locale for this client instance.
void	setLocalizationLocale(Locale loc) Changes the Locale used for the localization.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractClient

protected AbstractClient()

Default constructor.

AbstractClient

protected AbstractClient(Locale locale)

Overloaded constructor.

Parameters:

locale - the Locale for this client

Method Detail

getLocale

public Locale getLocale()

Retrieves the Locale for this client instance.

Returns:

the Locale for this client instance

setLocale

public void setLocale(Locale locale)

Sets the Locale for this client instance. Note that doing this after a call to setLocalizationLocale(Locale) overwrites the localization language with the input of this method.

Parameters:

locale - the Locale for this client

getLocalizationLocale

public Locale getLocalizationLocale()

Returns the Locale used for the localization.

Returns:

locale the Locale for the localization

setLocalizationLocale

public void setLocalizationLocale(Locale loc)

Changes the Locale used for the localization. Useful if the client needs to be in a different language than the error messages.

Parameters:

loc - the Locale for the localization

getRootUrl

protected String getRootUrl()

Determines the URL for the API based on the current Locale.

Returns:

the URL representing the entry point for the API

doGetRequest

protected String doGetRequest(String url)

Performs a GET request to the specified URL.

Parameters:

url - the URL which will be sent a GET request

Returns:

a string representation of the API's response

doPostRequest

protected String doPostRequest(String url,
                               String query)

Performs a POST request to the specified URL.

Parameters:

url - the URL which will be sent a POST request

query - the query which the API will process

Returns:

a string representation of the API's response

getUrl

public abstract String getUrl()

Returns the URL endpoint which this client represents.

Returns:

the URL endpoint for this client