Инъекция зависимостей без магии с JayWire

JayWire — это небольшая, простая в использовании библиотека Dependency Injection для Java 8, не требующая волшебства. Эта статья представляет собой краткое руководство о том, как начать использовать ее в проектах любого размера, от небольших одно- и до больших многомодульных.

Зачем нужна еще одна библиотека внедрения зависимостей?

Интересно, что ключевая особенность JayWire заключается не в том, что он может предоставлять объекты в качестве зависимостей другим объектам, а также в том, что объекты могут быть определены как имеющие область действия (например, одноэлементная область, область запроса и т. Д.). Все они поддерживаются любой другой структурой DI.

Отличительной особенностью этой библиотеки является то, что она не использует «магию» для достижения этих функций, и поэтому ее легче понять, она менее ограничена в отношении объектов, с которыми она может работать, и архитектур, которые она может поддерживать.

В частности, следующие технические решения все считаются «магическими», и их избегают в JayWire:

• Classpath-сканирование
• отражение
• Аннотации
• Улучшение байт-кода / ткачество, АОП
• Прозрачные прокси-объекты
• Генерация кода или специальные плагины компилятора
• Скрытое статическое состояние

Таким образом, JayWire является на 100% Java-кодом, не навязывает свою модель программирования объектам, находящимся в управлении, статически безопасен, при необходимости может быть отлажен или зарегистрирован и может использоваться несколько раз в одной JVM.

Постановка проблемы: внедрение зависимости

Проблема на самом деле удивительно проста: некоторым объектам нужны другие объекты для работы. Эти «другие» объекты называются зависимостями, а акт предоставления этих зависимостей нуждающимся в них объектам называется инъекцией. Это выглядит так:

public interface Database {
}

public class PeopleRepository {
   public PeopleRepository(Database database) {
      ...
   }
}

new PeopleRepository(new SomeDatabaseImpl(...));

public class MyApplication {
   public PeopleRepository getPeopleRepository() {
      ...
   }

   public GroupRepository getGroupRepository() {
      ...
   }

   public WebServer getWebServer() {
      return new WebServer(getPeopleRepository(), getGroupRepository());
   }
}

new MyApplication().getWebServer().start();

public class MyApplication {
   public Database getDatabase() {
      ...
   }

   public PeopleRepository getPeopleRepository() {
      return new PeopleRepository(getDatabase());
   }

   public GroupRepository getGroupRepository() {
      return new GroupRepository(getDatabase());
   }

   ...
}

public class MyApplication {
   private Database database;

   public synchronized Database getDatabase() {
      if (database != null) {
         database = new SomeDatabaseImpl(...);
      }
      return database;
   }

   ...
}

public class MyApplication extends StandaloneModule {
   public Database getDatabase() {
      return singleton( () -> new SomeDatabaseImpl(...) );
   }

   ...
}

public class OrganizationService {
   public User currentUser;

   public OrganizationService(User currentUser) {
      this.currentUser = currentUser;
   }

   public List<Employee> getSubordinates() {
      return currentUser.getSubordinates();
   }
}

import java.util.function.Supplier;

public class OrganizationService {
   public Supplier<User> currentUserSupplier;

   public OrganizationService(Supplier<User> currentUserSupplier) {
      this.currentUserSupplier = currentUserSupplier;
   }

   public List<People> getSubordinates() {
      return currentUserSupplier.get().getSubordinates();
   }
}

public class MyApplication extends SparkModule {
   public Supplier<User> getCurrentUserSupplier() {
      return sessionScope( () -> new User(...) );
   }

   public OrganizationService getOrganizationService() {
      return new singleton( () -> new OrganizationService(getCurrentUserSupplier()) );
   }
}

public abstract class RepositoryModule extends StandaloneModule {
   public abstract Database getDatabase();

   public PeopleRepository getPeopleRepository() {
      return singleton( () -> new PeopleRepository(getDatabase()) );
   }

   public GroupRepository getGroupRepository() {
      return singleton( () -> new GroupRepository(getDatabase()) );
   }

   ...
}

public abstract class RepositoryModule implements SingletonScopeSupport {
   public abstract Database getDatabase();

   public PeopleRepository getPeopleRepository() {
      return singleton( () -> new PeopleRepository(getDatabase()) );
   }

   public GroupRepository getGroupRepository() {
      return singleton( () -> new GroupRepository(getDatabase()) );
   }

   ...
}

public interface RepositoryModule extends SingletonScopeSupport {
   Database getDatabase();

   default PeopleRepository getPeopleRepository() {
      return singleton( () -> new PeopleRepository(getDatabase()) );
   }

   default GroupRepository getGroupRepository() {
      return singleton( () -> new GroupRepository(getDatabase()) );
   }

   ...
}

public class MyApplication extends SparkModule implements
   RepositoryModule, DatabaseModule, WebPagesModule {

   @Override
   public Database getDatabase() {
      return getSomeSpecificDatabase();
   }
}