Конфигурация Apache Tamaya

После JavaOne 2014, когда тема конфигурации была отменена из списка EE8, Дэвид Блевинс и другие предложили запустить проект Apache по нескольким причинам:

• Пусть люди с опытом работы в теме идентифицируют общий набор функций.
• Реализуйте идеи как часть проекта Apache, чтобы предоставить идеи с использованием бесплатной и распространяемой лицензии.
• Используйте общепринятую проверенную организацию, способную обеспечить успешное принятие. Это было, когда  Apache Tamaya  был помещен в инкубацию. После этого у нас было несколько обсуждений, видеовстреч и электронных писем. В результате  Apache Tamaya  теперь доступен в виде 0.1-инкубатора первого выпуска  , готового к использованию.

Также стоит упомянуть, что Марк Струберг и Герхард Петрачек, ребята из Deltaspike, присоединились к этому проекту и активно участвовали в нем. Я думаю, что стоит более глубоко взглянуть на проект. Об этом и рассказывается в этом блоге.

Проект Apache Tamaya

Как запрос спецификации Java

Apache Tamaya  построен аналогично запросу спецификации Java (JSR). Он представляет собой API, который определяет артефакты, с которыми обычно взаимодействуют пользователи, и предоставляет эталонную реализацию, которая реализует API, поэтому его можно использовать для реальных проектов. Причиной этого являются следующие:

1. Отделение API от реализации дает вам очень четкое и ясное представление о проблеме. Вы должны изолировать суть вашей проблемы и опустить все виды чрезмерно специфических аспектов. Если все сделано правильно, это приводит к простому и всеобъемлющему API, который в то же время достаточно мощный, чтобы поддерживать по крайней мере большинство или все другие требования (например, использование точек расширения или хуков для плагинов) в адаптированном или дополнительном функционале (иначе интерфейсы / SPI поставщика услуг).
2. API может быть более независимым, чем эталонная реализация, относительно его требований совместимости. Например, API на основе Java 7 Apache Tamaya фактически также совместим с платформами Java 6 и Java ME.
3. Вы можете начать с минимального набора функций в API и постепенно расширять его по мере необходимости. Каждое расширение должно быть проверено, если это действительно необходимо или требование не может быть реализовано с использованием существующего API / SPI. Это гарантирует, что ваш API действительно фокусируется на минимальных аспектах, поэтому становится понятным и понятным.
4. И последнее, но не менее важное, что-то в соответствии с предыдущим пунктом, добавление новых функций не мешает базовому API / реализации, что позволяет очень легко добавлять новые функции. Проект Apache Tamaya также содержит довольно много так называемых расширений, которые зависят только от API, поэтому проект уже доказал, что способен очень эффективно охватить этот аспект.

Единственным отличием от JSR является отсутствие в настоящее время комплекта технической совместимости (TCK), который обеспечивает совместимость различных реализаций API с общим набором правил. Точно так же у нас нет чего-то вроде «спецификации» (но у нас есть очень обширная документация, чем-то очень похожая на спецификацию, также охватывающая многие аспекты / обсуждения, проведенные на этапе оценки для Java EE JSR 2 года назад).

Совместимость

Apache Tamaya в  настоящее время поддерживает как Java 7, так и Java 8. Причины этого в том, что на Java 7 по-прежнему много кода, особенно в корпоративном контексте, и мы хотели, чтобы люди могли использовать Apache Tamaya, прежде чем перейти к платформа Java 8. Тем не менее, API можно легко добавить в вашу сборку maven:

<dependency>
  <groupId>org.apache.tamaya</groupId>
  <artifactId>tamaya-java7-api</artifactId>
  <version>0.1-incubating</version>
</dependency>

<dependency>
  <groupId>org.apache.tamaya</groupId>
  <artifactId>tamaya-api</artifactId>
  <version>0.1-incubating</version>
</dependency>

<dependency>
  <groupId>org.apache.tamaya</groupId>
  <artifactId>tamaya-java7-core</artifactId>
  <version>0.1-incubating</version>
</dependency>

<dependency>
  <groupId>org.apache.tamaya</groupId>
  <artifactId>tamaya-core</artifactId>
  <version>0.1-incubating</version>
</dependency>

public interface Configuration {

  default String get(String key) {...}
  default <T> T get(String key, Class<T> type) {...}
  default Configuration with(ConfigOperator operator) {...}
  default <T> T query(ConfigQuery<T> query) {...}
  <T> T get(String key, TypeLiteral<T> type);   Map<String, String> getProperties();

  // not available for Java 7
  default Optional<String> getOptional(String key) {...}
  default <T> Optional<T> getOptional(String key, Class<T> type) {...}
  default <T> Optional<T> getOptional(String key, TypeLiteral<T> type) {...}
  default Optional<Boolean> getBoolean(String key) {...}
  default OptionalInt getInteger(String key) {...}
  default OptionalLong getLong(String key) {...}
  default OptionalDouble getDouble(String key) {...}
}

Configuration config = ConfigurationProvider.getConfiguration();

@FunctionalInterface
public interface ConfigOperator {
    Configuration operate(Configuration config);
}

@FunctionalInterface
public interface ConfigQuery<T> {
    T query(Configuration config);
}

BigDecimal interestRate = ConfigurationProvider.getConfiguration()
                .get("com.mycomp.ratecalculator.rate", BigDecimal.class);

BigDecimal interestRate = ConfigurationProvider.getConfiguration()
                .getOptional("com.mycomp.ratecalculator.rate", bBigDecimal.class)
                .orElse(BigDecimal.of(0.05d));

public class MyRateCalculator implements RateCalculator{

  private BigDecimal interestRate = ConfigurationProvider.getConfiguration()
                .getOptional("com.mycomp.ratecalculator.rate", BigDecimal.class)
                .orElse(BigDecimal.of(0.05d));

  public MonetaryAmount calcRate(MonetaryAmount amt, int periods){
    ...
  }

}

import org.apache.tamaya.ext.optional.OptionalConfiguration;

private BigDecimal interestRate = Optional.ofNullable(
                 OptionalConfiguration.of(
                    (k) -> MyConfigMechanism.get(k)) // String get(String key);                  )
                .get("com.mycomp.ratecalculator.rate", BigDecimal.class))
                .orElse(BigDecimal.of(0.05d));