Введение во внедрение контекстов и зависимостей и JSF 2.0

Составитель: Энди Гибсон (Andy Gibson), редактор: Трой Джуниперо (Troy Giunipero)

Внедрение контекстов и зависимостей (CDI), определяемое документом JSR-299, является неотъемлемой частью Java EE 6 и обеспечивает архитектуру, позволяющую компонентам Java EE (например, сервлетам, компонентам EJB и JavaBeans) существовать в жизненном цикле приложения с четко определенными контекстами. Кроме того, службы CDI позволяют компонентам Java EE (например, компонентам сеансов EJB и управляемым компонентам JavaServer Faces) внедряться и свободно взаимодействовать путем запуска и обработки событий.

Этот учебный курс основан на записи блога Энди Гибсона (Andy Gibson) Введение в JSF 2.0 и CDI в JEE 6. В нем рассматривается использование среды IDE для настройки веб-проекта Java с поддержкой JSF 2.0 и CDI. Затем описано связывание управляемых компонентов CDI со страницами Facelets и приводится краткий пример интеграции CDI и технологии EJB.

Среда IDE NetBeans предоставляет встроенную поддержку внедрения контекстов и зависимостей, включая возможность создания файла настройки CDI beans.xml после создания проекта, поддержку редактора и переходов для аннотаций, а также различные мастеры для создания общеиспользуемых артефактов CDI.

• В состав пакета среды IDE NetBeans для Java также входит сервер GlassFish Server Open Source Edition 3.x, который представляет собой контейнер с поддержкой Java EE 6.
• Поддержка CDI также доступна в NetBeans 6.8 после установки Исправления 1.

Создание веб-проекта Java с поддержкой CDI

В этом упражнении выполняется создание веб-проекта Java с поддержкой JSF 2.0 и CDI.

1. Нажмите кнопку "Новый проект" ( ) на главной панели инструментов IDE (CTRL+SHIFT+N; ⌘-SHIFT+ в ОС Mac).
2. В мастере создания проекта выберите категорию Java Web и команду "Веб-приложение". Нажмите кнопку "Далее".
3. Введите cdiDemo в качестве имени проекта и укажите местоположение проекта. Нажмите кнопку "Next" (Далее).
4. Укажите "GlassFish 3.x" в качестве сервера и "Java EE 6 Web" в качестве версии Java EE. Убедитесь, что установлен флажок "Разрешить внедрение контекстов и зависимостей".
   
   При выборе параметра "Включить внедрение контекстов и зависимостей" создается файл beans.xml в папке проекта WEB-INF при создании шаблона проекта. Файл beans.xml используется CDI для указания серверу, совместимому с Java EE, что проект является модулем, содержащим компоненты CDI.
5. Нажмите кнопку "Next" (Далее).
6. На панели "Платформы" выберите параметр JavaServer Faces.
7. Перейдите на вкладку "Настройка" и убедитесь, что в качестве предпочтительного языка страницы выбран "Facelets". Нажмите кнопку "Готово".

   При нажатии кнопки "Завершить" в среде IDE создается проект веб-приложения и в редакторе открывается страница приветствия index.xhtml.

8. В окне "Проекты" откройте папку Web Pages > WEB-INF и обратите внимание на отображаемый файл beans.xml Файл пуст, но может использоваться как альтернатива аннотациям для указания информации, связанной с компонентами, в формате XML.
   

   Если развернуть узел "Библиотеки > Сервер GlassFish", вы увидите, что была автоматически добавлена библиотека weld-osgi-bundle.jar. В состав сервера GlassFish входит Weld, который является реализацией спецификации CDI JSR-299 от JBoss.

Доступ к Beans из языка выражений JSF

В этом упражнении демонстрируется способ связи компонентов, управляемых CDI, со страницами Facelets с помощью синтаксиса EL.

1. В окне "Проекты" щелкните правой кнопкой узел "Исходные файлы" и выберите команду "Создать" > "Класс Java".
2. В мастере создания класса Java введите имя класса MessageServerBean и введите exercise1 в поле "Пакет". Новый пакет будет создан после завершения работы мастера.
   
3. Нажмите кнопку "Готово". Создаются новый пакет и класс, после чего класс открывается в редакторе.
4. Создайте аннотацию к классу с помощью javax.inject.Named и создайте простой метод, возвращающий строку.

   package exercise1;
   
   import javax.inject.Named;
   
   @Named
   public class MessageServerBean {
   
       public String getMessage() {
           return "Hello World!";
       }
   }

   После ввода аннотации @Named нажмите сочетание клавиш CTRL+ПРОБЕЛ для вызова автозавершения кода и документации Java. Если применить аннотацию с помощью функций автозавершения кода редактора (например, выбрав подходящую аннотацию и нажав клавишу ВВОД), в файл автоматически добавляется оператор импорта .
   
   Во всплывающем меню документации Javadoc также можно выбрать пункт "Показать документацию во внешнем веб-браузере" () для отображения полноразмерного окна с документацией Javadoc.
5. Сохраните файл (CTRL+S; ⌘+S в системе Mac). После добавления аннотации @Named класс MessageServerBean стал управляемым компонентом , в соответствии с определением CDI.
6. Переключитесь в редакторе на страницу Facelets index.xhtml(нажмите сочетание клавиш CTRL+TAB) и добавьте следующий текст в теги <h:body>.

   <h:body>
       Hello from Facelets
       <br/>
       Message is: #{messageServerBean.message}
       <br/>
       Message Server Bean is: #{messageServerBean}
   </h:body>

   Для отображения подсказок автодополнения кода можно нажать сочетание клавиш CTRL+ПРОБЕЛ внутри выражения EL. Списки автодополнения редактора содержат управляемые компоненты и их свойства. Поскольку аннотация @Named преобразует класс MessageServerBean в управляемый компонент, он становится доступным в синтаксисе EL, как если бы он был управляемым компонентом JSF.
   
7. Нажмите кнопку "Выполнить проект" () на главной панели инструментов среды IDE. Файл компилируется и развертывается в GlassFish, и страница приветствия приложения (index.xhtml ) отображается в веб-обозревателе. На странице отображается текст "Hello World!" из MessageServerBean.
   
8. Вернитесь к компоненту сообщения и измените сообщение на другое (например, "Hello Weld!"). Сохраните файл (CTRL+S; ⌘+S в ОС Mac), затем обновите обозреватель. Автоматически отображается новое сообщение. Это происходит благодаря возможности "Развертывание при сохранении" среды IDE, все сохраненные изменения вызывают компиляцию и повторное развертывание на сервере.
   
   В третьей строке на этой странице видно, что имя класса – exercise1.MessageServerBean Обратите внимание, что компонент представляет собой объект POJO (Plain Old Java Object, простой старый объект Java). Несмотря на использование Java EE, при разработке отсутствует комплексная иерархия классов, связанная уровнями транзакций, перехватами и другие сложные особенности.

Переход к EJB

Благодаря EJB 3.1 и использованию стека Java EE можно с небольшими изменениями легко развертывать компонент в качестве EJB.

1. Откройте MessageServerBean и добавьте аннотацию javax.ejb.Stateless на уровне класса, затем замените строку на "Hello EJB!".

   package exercise1;
   
   import javax.ejb.Stateless;
   import javax.inject.Named;
   
   /**
    *
    * @author nbuser
    */
   @Named
   @Stateless
   public class MessageServerBean {
   
       public String getMessage() {
           return "Hello EJB!";
       }
   }

2. Сохраните файл (CTRL+S; ⌘+S в ОС Mac), затем обновите страницу в обозревателе. Отображается приблизительно следующее:
   
   Поразительно, POJO превратился в полнофункциональный EJB с помощью всего одной аннотации. После сохранения изменений и обновления страницы были отображены изменения. Для этого не потребовалось проводить комплексную настройку проекта, создавать локальные интерфейсы или сложные дескрипторы развертывания.

Дополнительные сведения

В следующей части рассматривается внедрение CDI и приведены подробности использования CDI для управления зависимостями в среде Java EE 6.

• Работа с внедрением и квалификаторами в CDI

Дополнительные сведения о CDI и JSF 2.0 приведены в следующих материалах.