WeatherServiceRequester.java

package org.silverpeas.looks.aurora.service.weather;

import org.silverpeas.core.util.ServiceProvider;

import javax.enterprise.inject.Default;
import javax.enterprise.util.AnnotationLiteral;

/**
 * Requester of a remote weather service to fetch weather forecast data over several days.
 * @author mmoquillon
 */
@FunctionalInterface
public interface WeatherServiceRequester {

  /**
   * Gets the requester relative to the specified weather service.
   * @param serviceName a name of the weather service
   * @return the requester for the specified weather service. If the service isn't supported, then
   * returns the default weather service used by Silverpeas.
   */
  static WeatherServiceRequester getForService(final String serviceName) {
    try {
      return ServiceProvider.getService(serviceName);
    } catch (Exception e) {
      return ServiceProvider.getService(WeatherServiceRequester.class,
          new AnnotationLiteral<Default>() {
          });
    }
  }

  /**
   * Request weather forecast data of the specified city. If the requesting fails, then a
   * {@link javax.ws.rs.WebApplicationException} is thrown.
   * @param cityId a unique identifier of a city. Such identifiers are specific to the weather
   * service.
   * @return a JSON or an XML representation of the weather forecast data.
   */
  WeatherForecastData request(final String cityId);
}