Programming:PluginFeaturesRegistration

Материал из wiki

Правила и порядок регистрации/публикации возможностей Plugin-ов

Общие понятия

Исходный Java код как самой платформы USKat, так и систем на её основе организован в виде плагинов (Plugin) в IDE Eclipse. Естественно, плагины создают иерархию зависимостей. Например, код платформы uskat зависит от кода базовых библотек tslib, а код продука зависит от кода платформы. Более базовый плагин, от которого заисит другой, называем библиотекой. Большинство библиотек сами зависят от еще более базовых библиотек.

Смысл библиотеки (библиотечного плагина) в том, что он предоставляет свой код зависимому плагину. Но непосредственно экспорта кода, библиотека экспортирует еще и некие возможности (featurtsб фичи), наличие которых подразумевается зависимыми плагинами.

Вот некоторые из фич (платформы ts4/uskat), которые должны делать доступным библиотеки:

  • объекты-значения (valobjs, value-objects) - Имеющие KEEPER требущие регистрации в TsValobjUtils;
  • M5-модели, экземпляры которых заносятся в домен методом M5Domain.addModel();
  • ValedXxx редаторы, которые требуют регистрации фабрик в IValedControlFactoriesRegistry;
  • и многое другое, например всё, что должно наодится в контексте приложения IEclipseContext.

Обратите внимание, что все такие фичи должны быть зарегистрированы в некоторых реестрах, контекстах и т.п. до того, как к ним в первый раз обратится зависимый плагин. То есть, используя библиотеку, зачастую недостаточно просто сделать Java import, нужно гарантировать, что до того, как вызовется код зависимого плагина, будет вызван код регистрации фич базового плагина.

Для этого, в платформе ts4 существует механизм квантов (Quants) и адонов (Addons из фреймворка Eclipse E4). Эти два механизма делают одно и то же - вызывают код инициализации (регистрации) публикуемых фич плагина. Разница в том, что кванты используются в обычных плагина, которые содержат только Java-код, а адоны в плагинах, имеющих фрагменты Eclipse E4 модели. Кроме того, квант - механизм платформы ts4 и его надо программисту на платформе "запустить" самому, а адоны интегрированы в Eclipse E4 фреймворк построения GUI приложении, и их автоматически инициализирует GUI программа при старте. Квант же слеует явно "запустиь" однним из нижеописанных способом.

Практическое использование

??? этот кусок еще будет дописан....