Модульная система GlassFish: как расширить CLI GlassFish и консоль веб-администрирования (часть I, Архитектура)

Когда GlassFish запускается , обычно используя свою внутреннюю среду OSGI или внешнюю среду OSGI, сначала он загружает ядро ​​GlassFish и проверяет все доступные службы, изучая реализацию различных контрактов в пути к классам и . Ядро будет загружать только те сервисы, которые необходимы во время запуска, или сервисы, на которые ссылается другой сервис как на одну из его зависимостей.

Контейнеры услуга будет только начинается , если приложение получить развернутую в контейнер, администрирование расширения консоли загрузка , как только консоль администрирования нагрузки, CLI команды нагрузки по требованию и системам не поджать все команды , когда asadmin начинается , мониторинг модули начинаются , когда клиент связывается с ними ,

Модульная система GlassFish применяется не только к специфическим возможностям сервера приложений, таким как расширение консоли администрирования, но также применяется к реализации спецификаций Java EE . GlassFish использует разные модули OSGI для разных спецификаций Java EE, таких как Servlet 3 и JSF 2. Эти спецификации объединены с использованием OSGI, чтобы упростить обновление системы при появлении новой версии каждой спецификации.

Различные модули GlassFish вписываются в разные категории ядра GlassFish. Эти классификации модулей являются результатом модулей, реализующих предоставленные GlassFish интерфейсы для различных точек расширения. Мы обсудим точки расширения в деталях режима в разделе 3.

Новые функции, добавленные в GlassFish с использованием модульной системы, не будут отличаться от стандартных функций GlassFish, поскольку новые модули полностью вписываются в общие предоставляемые функции.

А Л.Л. расширяемость точка в GlassFish предназначена для того , чтобы при добавлении нового типа контейнеров для размещения языков программирования и рамок, кроме Java легко справиться. Каждый контейнер, доступный для сервера приложений GlassFish, добавляет свой собственный набор команд консоли, веб-страницы консоли администрирования и узлы навигации, а также собственные модули мониторинга для измерения необходимых метрик.

Представляем OSGI 

OSGI — это обширная структура, представленная для добавления возможностей модульности в Java перед поставкой Java SE 7. По сути, OSGI представляет собой совокупность нескольких уровней функциональности, которые строятся друг на друге, чтобы освободить разработчиков Java от головной боли при преодолении сложности загрузчика классов, возможности динамического подключения, управления версиями библиотек, видимости кода, управления зависимостями; и модель публикации, поиска и привязки для разделения пакетов. Расслоение OSGI дает нам нечто похожее на рисунок 1.

Рисунок 1 OSGi слои , GlassFish использует все , кроме слоя обслуживания. Приложение на основе OSGI может использовать все или некоторые уровни в дополнение к платформе OS и Java, на которой работает OSGI.

OSGI работает на портативных устройствах с поддержкой профиля CDC и Java SE. Так что от OSGI могут выиграть различные операционные системы и устройства . Над этой минимальной платформе OSGi слои маршируют друг над другом и на основе принципов слоя эд архитектуры каждый слой может видеть только ее нижний слой , а не его верхний слой.

Bundle или модуль слой ближе к платформе Java SE, OSGi расслоения Jar файлы , которые еще некоторые мета информационных данных, эти метаданные обычно определяют модули , необходимые и предоставляемых интерфейсы, но это делает эту задачу очень эффективно. OSGi расслоения обеспечивают 7 дезертирства , чтобы помочь с зависимостями, управление версиями. Эти определения включают в себя:

• Поддержка нескольких версий: в фреймворке может существовать несколько версий одного и того же пакета . И зависимые пакеты могут использовать версии, которые удовлетворяют их требованиям

• Фрагменты пакета : позволяет расширять содержимое пакета , пакеты могут объединяться в один пакет и предоставлять унифицированные атрибуты экспорта и импорта .

• Зависимости пакетов : позволяет при необходимости тесно связывать пакеты. Импортировать все, что экспортирует другой пакет. Позволяет реэкспортировать и разбивать пакеты.

• Явные код границ и зависимости : Связки могут явно их внутренние пакеты или зависимости объявляют на внешних пакетах .
• Произвольные атрибуты экспорта / импорта для большего контроля : экспортеры могут прикреплять произвольные атрибуты к своим экспортам; импортеры могут сопоставлять эти произвольные атрибуты, когда они находят требуемый пакет и перед импортом .
• Сложная модель согласованности пространства классов
• Фильтрация пакетов для детальной видимости классов : Экспортеры могут объявить, что определенные классы включены / исключены из экспортируемого пакета .

Все эти определения включены в файл MANIFEST.MF, который легко читать и создавать текстовый файл, расположенный в каталоге META-INF файлов jar. В листинге 4 приведен пример файла MANIFEST.MF.

Пример файла MANIFIST.MF в листинге 4, в котором показаны некоторые определения модулей OSGI

Bundle-ManifestVersion: 2                                       #1
Bundle-SymbolicName: gfbook.samples.chapter12                    #2
Bundle-Version: 1.1.0                                            #2
Bundle-Activator: gfbook.samples.chapterActivator             #3 
Bundle-ClassPath: .,gfbook/lib/juice.jar                          #4
Bundle-NativeCode:                                                #5
serialport.so; osname=Linux; processor=x86,                        #5
serialport.dll; osname=Windows 98; processor=x86                   #5
Import-Package: gfbook.samples.chapter7; version="[1.0.0,1.1.0)";  #6
resolution:="optional"                                             #6
Export-Package:                                                    #7
gfbook.samples.chapterservices.monitoring; version=1.1;          #7
vendor="gfbook.samples:"; exclude:="*Impl",                         #7
gfbook.samples.chapterservices.logging; version=1.1;             #8
uses:="samples.chapter7.services"                                   #8

GlassFish использует OSGI Revision 4, и номер версии в # 1 указывает на это. На # 2 мы однозначно идентифицируем этот комплект с именем и его версией вместе. На # 3 мы определяем в классе каких орудия BundleActivator интерфейса для того , чтобы позволить сверток получить уведомление , когда он останавливается или начинается. Это позволяет разработчикам выполнить инициализацию и выполнить некоторые проверки при запуске пакета или выполнить некоторую очистку после его остановки. В # 4 мы определяем наш пучок внутреннего пути к классу, расслоение имеет JAR — файлы внутри него и погрузчик расслоения класса проверить этокласс путь , когда он ищет классы , что он требует в том же порядке , указанном в Bundle- пути к классам заголовка . На # 5 мы определяем собственные зависимости пакета для каждой операционной системы.

@Service (name="restart-domain",                                  #1
scope=org.jvnet.hk2.component.PerLookup.class,                                    
factory=gfbook.chapterCommandFactory)
public class RestartDomain implements AdminCommand {                     #2
...
}

@Service (name="restart-domain",                                 scope=org.jvnet.hk2.component.PerLookup.class,                                    
factory=gfbook.chapterCommandFactory)
public class RestartDomain implements AdminCommand {                   
@Extract                                                                                                                  #1
LoggerService logger;
@Extract                                                                                                  #2
public CounterService getCounterService() {...}
}

@Service (name="restart-domain",                                 scope=org.jvnet.hk2.component.PerLookup.class,                                    
factory=gfbook.chapterCommandFactory)
public class RestartDomain implements AdminCommand {                   
@Inject protected Habitat habitat;                                                                      #1
public void performAudition() {
LoggerService logger = habitat.getComponent(LoggerService.class);         #2
CounterService counter = habitat.getComponent(CounterService.class);       #2
}
}

@Service(name = "TextApplicationSniffer")
@Scoped(Singleton.class)
public interface TextApplicationSniffer implements Sniffer{
    public boolean handles(ReadableArchive source, ClassLoader loader){} #1
    public Class<? extends Annotation>[] getAnnotationTypes(){}          #2
    public String[] getURLPatterns(){}                                   #3
    public String getModuleType(){}                                      #4
    public Module[] setup(String containerHome, Logger logger) throws IOException(){}                                                       #9
    public void tearDown(){}                                           #5
    public String[] getContainersNames(){}                              #6
   public boolean isUserVisible(){}                                    #7
    public Map<String,String> getDeploymentConfigurations(final          ReadableArchive source) throws IOException{}                            #8
}

@Service(name = "gfbook.chaptercontainer.TextApplicationContainer")         #1
public class TextApplicationContainer implements Container {                   #2
    public Class<? extends Deployer> getDeployer() {                #3
        return gfbook.chaptercontainer.TextApplicationDeployer.class;#3
    }

    public String getName() {
        return " Text Container";                     #4
    }

@Service
public class TextApplicationDeployer implements Deployer<TextContainer,    TextApplication> {                   #1
     public boolean prepare(DeploymentContext context) {    } #2

    public <T> T loadMetaData(Class<T> type, DeploymentContext context) { }#3

    public MetaData getMetaData() {}#4

    public TextApplication load(TextContainer container, DeploymentContext context) {}                               #5

    public void unload(TextApplication container, DeploymentContext context) {}                  #6

    public void clean(DeploymentContext context) {}  #6

}

public class TextApplication extends TextApplicationAdapter
                implements ApplicationContainer{ #1
 public boolean start(ApplicationContext startupContext) {   }

  public boolean stop(ApplicationContext stopContext) {  }

  public boolean resume()

  public ClassLoader getClassLoader() {  }

  public boolean suspend()

  public Object getDescriptor() {  } #2

}