com.survivingwithandroid.weather.lib.client.okhttp

Class WeatherDefaultClient

java.lang.Object

com.survivingwithandroid.weather.lib.WeatherClient

com.survivingwithandroid.weather.lib.client.okhttp.WeatherDefaultClient

public class WeatherDefaultClient
extends WeatherClient

${copyright}.

Nested Class Summary

Nested classes/interfaces inherited from class com.survivingwithandroid.weather.lib.WeatherClient

WeatherClient.CityEventListener, WeatherClient.ClientBuilder, WeatherClient.ForecastWeatherEventListener, WeatherClient.GenericRequestWeatherEventListener<T>, WeatherClient.HistoricalWeatherEventListener, WeatherClient.HourForecastWeatherEventListener, WeatherClient.WeatherClientListener, WeatherClient.WeatherEventListener, WeatherClient.WeatherImageListener

Field Summary

Fields inherited from class com.survivingwithandroid.weather.lib.WeatherClient

cityListener, ctx, LOCATION_TIMEOUT, locListener, provider

Constructor Summary

Constructors

Constructor and Description
WeatherDefaultClient()

Method Summary

Methods

Modifier and Type	Method and Description
void	getCurrentCondition(java.lang.String location, WeatherClient.WeatherEventListener listener) Deprecated. use instead WeatherClient.getCurrentCondition(com.survivingwithandroid.weather.lib.request.WeatherRequest, com.survivingwithandroid.weather.lib.WeatherClient.WeatherEventListener)
void	getCurrentCondition(WeatherRequest wRequest, WeatherClient.WeatherEventListener listener) Get the current weather condition.
void	getDefaultProviderImage(java.lang.String icon, WeatherClient.WeatherImageListener listener) This is the default image Provider that can be used to get the image provided by the Weather provider
void	getForecastWeather(java.lang.String location, WeatherClient.ForecastWeatherEventListener listener) Deprecated. use instead WeatherClient.getForecastWeather(com.survivingwithandroid.weather.lib.request.WeatherRequest, com.survivingwithandroid.weather.lib.WeatherClient.ForecastWeatherEventListener)
void	getForecastWeather(WeatherRequest wRequest, WeatherClient.ForecastWeatherEventListener listener) Get the forecast weather condition.
void	getHistoricalWeather(java.lang.String location, java.util.Date d1, java.util.Date d2, WeatherClient.HistoricalWeatherEventListener listener) Deprecated. use instead WeatherClient.getHistoricalWeather(com.survivingwithandroid.weather.lib.request.WeatherRequest, java.util.Date, java.util.Date, com.survivingwithandroid.weather.lib.WeatherClient.HistoricalWeatherEventListener)
void	getHistoricalWeather(WeatherRequest wRequest, java.util.Date d1, java.util.Date d2, WeatherClient.HistoricalWeatherEventListener listener) Get the historical weather condition.
void	getHourForecastWeather(java.lang.String location, WeatherClient.HourForecastWeatherEventListener listener) Deprecated. use instead WeatherClient.getHourForecastWeather(com.survivingwithandroid.weather.lib.request.WeatherRequest, com.survivingwithandroid.weather.lib.WeatherClient.HourForecastWeatherEventListener)
void	getHourForecastWeather(WeatherRequest wRequest, WeatherClient.HourForecastWeatherEventListener listener) Get the forecast weather condition.
void	getImage(java.lang.String url, WeatherClient.WeatherImageListener listener) Get an image at the specified URL and inform the listener when the image is ready
<T extends WeatherProviderFeature,S> void	getProviderWeatherFeature(WeatherRequest wRequest, T extRequest, GenericResponseParser<S> parser, WeatherClient.GenericRequestWeatherEventListener<S> listener) Get a specific weather provider feature not implemented in all weather provider When the data is ready this method calls the onWeatherRetrieved passing the HistoricalWeather weather information.
void	getWeatherImage(java.lang.String cityId, Params params, WeatherClient.WeatherImageListener listener) This method retrieves the image using the url generated by the weahter provider IWeatherProvider
void	searchCity(double lat, double lon, WeatherClient.CityEventListener listener) Search the city using latitude and longitude.
void	searchCity(java.lang.String pattern, WeatherClient.CityEventListener listener) Search the city using a name pattern.
void	searchCityByLocation(Criteria criteria, WeatherClient.CityEventListener listener) Search the city using geographic coordinates.
protected void	searchCityByLocation(Location location, WeatherClient.CityEventListener listener)

Methods inherited from class com.survivingwithandroid.weather.lib.WeatherClient

createDefaultCriteria, createProvider, handleLocation, init, setProvider, updateWeatherConfig

Methods inherited from class java.lang.Object

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

Constructor Detail

WeatherDefaultClient

public WeatherDefaultClient()

Method Detail

getCurrentCondition

public void getCurrentCondition(java.lang.String location,
                       WeatherClient.WeatherEventListener listener)
                         throws ApiKeyRequiredException

Deprecated. use instead WeatherClient.getCurrentCondition(com.survivingwithandroid.weather.lib.request.WeatherRequest, com.survivingwithandroid.weather.lib.WeatherClient.WeatherEventListener)

Get the current weather condition. It returns a class structure that is indipendent from the provider used to ge the weather data. This method is an async method, in other word you have to implement your listener WeatherClient.WeatherEventListener to get notified when the weather data is ready.

When the data is ready this method calls the onWeatherRetrieved passing the current weather information. If there are some errors during the request parsing, it calls onWeatherError passing the exception or onConnectionError if the errors happened during the HTTP connection

Specified by:

getCurrentCondition in class WeatherClient

Parameters:

location - a String representing the location id

listener - WeatherClient.WeatherEventListener

Throws:

ApiKeyRequiredException

searchCity

public void searchCity(java.lang.String pattern,
              WeatherClient.CityEventListener listener)
                throws ApiKeyRequiredException

Search the city using a name pattern. It returns a class structure that is indipendent from the provider used that holds the city list matching the pattern. This method is an async method, in other word you have to implement your listener WeatherClient.CityEventListener to get notified when the weather data is ready.

When the data is ready this method calls the onCityListRetrieved passing a List of cities. If there are some errors during the request parsing, it calls onWeatherError passing the exception or onConnectionError if the errors happened during the HTTP connection

Specified by:

searchCity in class WeatherClient

Parameters:

pattern - a String representing the pattern

listener - WeatherClient.CityEventListener

Throws:

ApiKeyRequiredException

searchCity

public void searchCity(double lat,
              double lon,
              WeatherClient.CityEventListener listener)
                throws ApiKeyRequiredException

Search the city using latitude and longitude. It returns a class structure that is indipendent from the provider used that holds the city list matching the pattern. This method is an async method, in other word you have to implement your listener WeatherClient.CityEventListener to get notified when the weather data is ready.

When the data is ready this method calls the onCityListRetrieved passing a List of cities. If there are some errors during the request parsing, it calls onWeatherError passing the exception or onConnectionError if the errors happened during the HTTP connection

Specified by:

searchCity in class WeatherClient

Parameters:

lat - a double representing the latitude

lon - a double representing the longitude

listener - WeatherClient.CityEventListener

Throws:

ApiKeyRequiredException

Since:

1.5.3

getForecastWeather

public void getForecastWeather(java.lang.String location,
                      WeatherClient.ForecastWeatherEventListener listener)
                        throws ApiKeyRequiredException

Deprecated. use instead WeatherClient.getForecastWeather(com.survivingwithandroid.weather.lib.request.WeatherRequest, com.survivingwithandroid.weather.lib.WeatherClient.ForecastWeatherEventListener)

Get the forecast weather condition. It returns a class structure that is independent from the provider used to ge the weather data. This method is an async method, in other word you have to implement your listener WeatherClient.ForecastWeatherEventListener to get notified when the weather data is ready.

When the data is ready this method calls the onWeatherRetrieved passing the WeatherForecast weather information. If there are some errors during the request parsing, it calls onWeatherError passing the exception or onConnectionError if the errors happened during the HTTP connection

Specified by:

getForecastWeather in class WeatherClient

Parameters:

location - a String representing the location id

listener - WeatherClient.ForecastWeatherEventListener

Throws:

ApiKeyRequiredException

getHourForecastWeather

public void getHourForecastWeather(java.lang.String location,
                          WeatherClient.HourForecastWeatherEventListener listener)
                            throws ApiKeyRequiredException

Deprecated. use instead WeatherClient.getHourForecastWeather(com.survivingwithandroid.weather.lib.request.WeatherRequest, com.survivingwithandroid.weather.lib.WeatherClient.HourForecastWeatherEventListener)

Get the forecast weather condition. It returns a class structure that is independent from the provider used to ge the weather data. This method is an async method, in other word you have to implement your listener WeatherClient.HourForecastWeatherEventListener to get notified when the weather data is ready.

When the data is ready this method calls the onWeatherRetrieved passing the WeatherHourForecast weather information. If there are some errors during the request parsing, it calls onWeatherError passing the exception or onConnectionError if the errors happened during the HTTP connection

Specified by:

getHourForecastWeather in class WeatherClient

Parameters:

location - a String representing the location id

listener - WeatherClient.HourForecastWeatherEventListener

Throws:

ApiKeyRequiredException

getHistoricalWeather

public void getHistoricalWeather(java.lang.String location,
                        java.util.Date d1,
                        java.util.Date d2,
                        WeatherClient.HistoricalWeatherEventListener listener)

Deprecated. use instead WeatherClient.getHistoricalWeather(com.survivingwithandroid.weather.lib.request.WeatherRequest, java.util.Date, java.util.Date, com.survivingwithandroid.weather.lib.WeatherClient.HistoricalWeatherEventListener)

Get the historical weather condition. It returns a class structure that is independent from the provider used to ge the weather data. This method is an async method, in other word you have to implement your listener WeatherClient.HistoricalWeatherEventListener to get notified when the weather data is ready.

When the data is ready this method calls the onWeatherRetrieved passing the HistoricalWeather weather information. If there are some errors during the request parsing, it calls onWeatherError passing the exception or onConnectionError if the errors happened during the HTTP connection

Specified by:

getHistoricalWeather in class WeatherClient

Parameters:

location - a String representing the location id

d1 - is the starting date

d2 -

listener - WeatherClient.HistoricalWeatherEventListener @param2 d2 is the end date

Throws:

ApiKeyRequiredException

getDefaultProviderImage

public void getDefaultProviderImage(java.lang.String icon,
                           WeatherClient.WeatherImageListener listener)

This is the default image Provider that can be used to get the image provided by the Weather provider

Specified by:

getDefaultProviderImage in class WeatherClient

Parameters:

icon - String The icon containing the weather code to retrieve the image

listener - WeatherClient.WeatherImageListener

searchCityByLocation

public void searchCityByLocation(Criteria criteria,
                        WeatherClient.CityEventListener listener)
                          throws LocationProviderNotFoundException

Search the city using geographic coordinates. It returns a class structure that is independent from the provider used that holds the city list matching the pattern. This method is an async method, in other word you have to implement your listener WeatherClient.CityEventListener to get notified when the weather data is ready.

When the data is ready this method calls the onCityListRetrieved passing a List of cities. If there are some errors during the request parsing, it calls onWeatherError passing the exception or onConnectionError if the errors happened during the HTTP connection

Specified by:

searchCityByLocation in class WeatherClient

Parameters:

criteria - android.location.Criteria

listener - WeatherClient.CityEventListener

Throws:

ApiKeyRequiredException

LocationProviderNotFoundException

getWeatherImage

public void getWeatherImage(java.lang.String cityId,
                   Params params,
                   WeatherClient.WeatherImageListener listener)

This method retrieves the image using the url generated by the weahter provider IWeatherProvider

Specified by:

getWeatherImage in class WeatherClient

Parameters:

cityId - String representing the city id

params - Params: list of parameters used to create the image

listener - WeatherClient.WeatherImageListener listener that gets notified when the image is ready to use

searchCityByLocation

protected void searchCityByLocation(Location location,
                        WeatherClient.CityEventListener listener)
                             throws ApiKeyRequiredException

Specified by:

searchCityByLocation in class WeatherClient

Throws:

ApiKeyRequiredException

getCurrentCondition

public void getCurrentCondition(WeatherRequest wRequest,
                       WeatherClient.WeatherEventListener listener)
                         throws ApiKeyRequiredException

Get the current weather condition. It returns a class structure that is indipendent from the provider used to ge the weather data. This method is an async method, in other word you have to implement your listener WeatherClient.WeatherEventListener to get notified when the weather data is ready.

When the data is ready this method calls the onWeatherRetrieved passing the current weather information. If there are some errors during the request parsing, it calls onWeatherError passing the exception or onConnectionError if the errors happened during the HTTP connection

Specified by:

getCurrentCondition in class WeatherClient

Parameters:

wRequest - WeatherRequest

listener - WeatherClient.WeatherEventListener

Throws:

ApiKeyRequiredException

getForecastWeather

public void getForecastWeather(WeatherRequest wRequest,
                      WeatherClient.ForecastWeatherEventListener listener)
                        throws ApiKeyRequiredException

Get the forecast weather condition. It returns a class structure that is independent from the provider used to ge the weather data. This method is an async method, in other word you have to implement your listener WeatherClient.ForecastWeatherEventListener to get notified when the weather data is ready.

When the data is ready this method calls the onWeatherRetrieved passing the WeatherForecast weather information. If there are some errors during the request parsing, it calls onWeatherError passing the exception or onConnectionError if the errors happened during the HTTP connection

Specified by:

getForecastWeather in class WeatherClient

Parameters:

wRequest - WeatherRequest

listener - WeatherClient.ForecastWeatherEventListener

Throws:

ApiKeyRequiredException

getHourForecastWeather

public void getHourForecastWeather(WeatherRequest wRequest,
                          WeatherClient.HourForecastWeatherEventListener listener)
                            throws ApiKeyRequiredException

Get the forecast weather condition. It returns a class structure that is independent from the provider used to ge the weather data. This method is an async method, in other word you have to implement your listener WeatherClient.HourForecastWeatherEventListener to get notified when the weather data is ready.

When the data is ready this method calls the onWeatherRetrieved passing the WeatherHourForecast weather information. If there are some errors during the request parsing, it calls onWeatherError passing the exception or onConnectionError if the errors happened during the HTTP connection

Specified by:

getHourForecastWeather in class WeatherClient

Parameters:

wRequest - WeatherRequest

listener - WeatherClient.HourForecastWeatherEventListener

Throws:

ApiKeyRequiredException

getHistoricalWeather

public void getHistoricalWeather(WeatherRequest wRequest,
                        java.util.Date d1,
                        java.util.Date d2,
                        WeatherClient.HistoricalWeatherEventListener listener)

Get the historical weather condition. It returns a class structure that is independent from the provider used to ge the weather data. This method is an async method, in other word you have to implement your listener WeatherClient.HistoricalWeatherEventListener to get notified when the weather data is ready.

When the data is ready this method calls the onWeatherRetrieved passing the HistoricalWeather weather information. If there are some errors during the request parsing, it calls onWeatherError passing the exception or onConnectionError if the errors happened during the HTTP connection

Specified by:

getHistoricalWeather in class WeatherClient

Parameters:

wRequest - WeatherRequest

d1 - is the starting date

d2 -

listener - WeatherClient.HistoricalWeatherEventListener @param2 d2 is the end date

Throws:

ApiKeyRequiredException

getProviderWeatherFeature

public <T extends WeatherProviderFeature,S> void getProviderWeatherFeature(WeatherRequest wRequest,
                                                                  T extRequest,
                                                                  GenericResponseParser<S> parser,
                                                                  WeatherClient.GenericRequestWeatherEventListener<S> listener)

Get a specific weather provider feature not implemented in all weather provider

When the data is ready this method calls the onWeatherRetrieved passing the HistoricalWeather weather information. If there are some errors during the request parsing, it calls onWeatherError passing the exception or onConnectionError if the errors happened during the HTTP connection

Specified by:

getProviderWeatherFeature in class WeatherClient

Parameters:

wRequest - WeatherRequest

extRequest - is the extended request as required by the weather provider

parser - is the parser used to parsed the response GenericResponseParser

listener - WeatherClient.GenericRequestWeatherEventListener

Throws:

ApiKeyRequiredException

getImage

public void getImage(java.lang.String url,
            WeatherClient.WeatherImageListener listener)

Get an image at the specified URL and inform the listener when the image is ready

Specified by:

getImage in class WeatherClient

Parameters:

url - String representing the url

listener - WeatherClient.WeatherImageListener

Since:

1.5.3