От OSGi до Jigsaw

В моем последнем посте я представил новую систему Java Platform Module с небольшим примером. По состоянию на сентябрь, есть игра с кодовым названием Jigsaw. После нескольких вводных игрушечных примеров я сделал то, что делает любой любопытный кодер: перенес знакомую (и не совсем тривиальную) кодовую базу на новую блестящую технологию. В этом случае я взял небольшую динамическую панель мониторинга на основе OSGi и реализовал ее с помощью предложенной системы модулей платформы Java.

Если вы хотите получить представление о том, что влечет за собой новая модульная система платформы Java (далее именуемая JPMS) и как начать работу, прочитайте «Система модулей Java: первый взгляд» . В этом посте предполагается, что вы знакомы с основами предлагаемой системы модулей. И если вы тот человек, который просто хочет увидеть код: вот, пожалуйста .

Оригинальное приложение OSGi

Прежде чем погрузиться в порт Jigsaw, давайте посмотрим, что представляет собой оригинальное приложение:

Как видите, он имитирует приборную панель автомобильной развлекательной системы. Однако требуется, чтобы эта автомобильная развлекательная система могла динамически расширяться и обновляться. Каждое из «приложений» происходит из отдельного пакета OSGi. Панель мониторинга собирает только те приложения, которые в данный момент подготовлены для среды выполнения OSGi, и показывает их. Вы можете нажать на значки, чтобы получить доступ к базовому «приложению» (музыкальный проигрыватель, навигация, телефон), которое происходит из того же пакета, что и значок панели инструментов. Этот пример послужил демонстрацией для выступления на конференции с моим коллегой  Полом Баккером  «Обеспечение IoT». В этом разговоре мы используем  Apache ACE динамически обновлять и предоставлять пакеты OSGi для запуска экземпляров автомобильной развлекательной системы на нескольких устройствах. Это действительно здорово видеть обновление вашей системы в режиме реального времени без перезагрузки. Если вы хотите увидеть это в действии, я рекомендую  посмотреть выступление . Демо начинается около 11 минут.

Технически динамическая панель поиска просматривает все экземпляры  App интерфейса в реестре службы OSGi. Этот интерфейс является практически единственным фрагментом кода, который публично распространяется между пакетами. В свою очередь, пакеты, содержащие  App реализацию, регистрируются при запуске пакета и отменяются при остановке пакета. Это в полной мере использует динамический жизненный цикл, предоставляемый OSGi. Сводная панель получает  App экземпляры из реестра служб без необходимости знать о классах реализации. Инверсия контроля в действии! Каждый пакет реализации приложения также предоставляет свои собственные ресурсы, такие как изображения. Вы можете проверить оригинальное приложение  на GitHub .

Нахождение правильных модулей

Вопрос в том, насколько сложно портировать это модульное приложение OSGi в JPMS с использованием прототипа Jigsaw? Быть таким же динамичным, как OSGi, не является целью JPMS. Поэтому, чтобы сдержать ожидания, я уже рад, если мы сможем портировать модуль и структуру сервиса при запуске. Динамическое добавление и удаление новых модулей придется подождать пока.

Наша задача — перевести пакеты OSGi в эквивалентные модули Jigsaw. Первым шагом для воссоздания этого примера в JPMS является выяснение того, что должно входить в  module-info.javaдескрипторы. Эти дескрипторы модулей содержат информацию о зависимостях для модулей Java. Это похоже на метаданные OSGi в файле манифеста jar-файлов OSGi.

Самое простое определение модуля — это определение для пакета API:

module carprov.dashboard.api {
   exports carprov.dashboard.api;
   requires public javafx.graphics;
}

$ jdeps -module -cp carprov.dashboard.api.jar carprov.dashboard.api.App
carprov.dashboard.api -> java.base
carprov.dashboard.api -> javafx.graphics
   carprov.dashboard.api (carprov.dashboard.api)
      -> java.lang                                          java.base
      -> javafx.scene                                       javafx.graphics

import javafx.scene.Node;

public interface App {
   String getAppName();
   int getPreferredPosition();   
   Node getDashboardIcon();
   Node getMainApp();
}

module carprov.dashboard.jfx {
   requires carprov.dashboard.api;
   requires javafx.base;
   requires javafx.controls;
   requires javafx.swing;

   uses carprov.dashboard.api.App;
}

Iterable<App> apps = ServiceLoader.load(App.class);

for(App app: apps) {
  renderDashboardIcon(app);
}

module carprov.phone {
   requires carprov.dashboard.api;
   requires javafx.controls;

   provides carprov.dashboard.api.App with carprov.phone.PhoneApp;
}

public static ImageView getImageByFullname(BundleContext bundleContext, String name) {
  URL entry = bundleContext.getBundle().getEntry(name);
  try {
    Image image = new Image(entry.openStream());
    ImageView view = new ImageView(image);
    view.setPreserveRatio(true);
    return view;
  } catch (IOException e) {
    throw new RuntimeException(e);
  }
}

public static ImageView getImageT(Class<?> loadingContext, String name) {
  Image image = new Image(loadingContext.getResourceAsStream(name));
  ImageView view = new ImageView(image);
  view.setPreserveRatio(true);
  return view;
}

public static ImageView getImage(InputStream stream) {
     Image image = new Image(stream);
     ImageView view = new ImageView(image);
     view.setPreserveRatio(true);
     return view;
}

Layer layer = Layer.boot();
for (Module m: layer.modules()) {
  if(m.getName().startsWith("carprov")) {
     String name = m.getName();
     Optional<Version> version = m.getDescriptor().getVersion();
     // Show it in the ui
  }
}