Создание класса сущностей

В этом упражнении с помощью мастера создания класса сущностей будет создан простой устойчивый класс сущностей. Также будет описан мастер создания единицы сохранения состояния, которая определяет источник данных и диспетчер сущностей, используемые в приложении. Будет добавлено одно поле в класс для представления данных в таблице и созданы методы получения и установки для нового поля.

Класс сущностей должен иметь первичный ключ. При создании класса сущностей с помощью мастера в среде IDE по умолчанию создается поле id и создается аннотация @Id для объявления этого поля в качестве первичного ключа. Также в среде IDE добавляется аннотация @GeneratedValue и указывается стратегия создания ключей для первичного поля id.

Использование в проекте интерфейса Java Persistence значительно упрощает разработку приложения в силу отсутствия необходимости настройки дескрипторов развертывания для определения информации относительно объектно-реляционного сопоставления для сохраняющих состояние полей или свойств. Вместо этого можно использовать аннотации для определения этих свойства непосредственно в простом классе Java.

Сохранением состояния объекта управляет интерфейс API EntityManager. Интерфейс API EntityManager обрабатывает контекст сохранения состояния, а каждый контекст сохранения состояния представляет собой группу экземпляров объекта. При разработке приложения для обозначения устойчивого экземпляра контекста для классов сущностей к классу можно добавить аннотации. В дальнейшем жизненный цикл экземпляров объекта управляется контейнером.

Для создания класса сущностей выполните следующие действия.

1. Щелкните узел проекта правой кнопкой мыши и выберите команду "Создать" > "Другие".
2. Выберите "Класс сущностей" в категории "Сохранение состояния". Нажмите кнопку "Далее".
3. В поле "Имя класса" введите Message.
4. В поле "Пакет" введите entities.
5. Нажмите кнопку "Создать модуль сохранения состояния". Нажмите кнопку "Далее".

   Примечание. При нажатии в среде IDE NetBeans 6.8 кнопки "Создать модуль сохранения состояния" будет открыто диалоговое окно создания модуля сохранения состояния.

6. Выберите источник данных (например, выберите jdbc/sample, если необходимо использовать JavaDB).

   Источник данных для jdbc/sample находится в составе пакета среды IDE при установке среды IDE и сервера приложений GlassFish. Однако можно указать другой источник данных, если это необходимо.

   Можно сохранить другие параметры по умолчанию (имя единицы сохранения состояния, поставщик сохранения состояния EclipseLink). Убедитесь в том, что для единицы сохранения состояния используется интерфейс Java Transaction API и что для стратегии создания таблиц установлено значение "Создать", т. е. таблицы на основе классов сущностей создаются при развертывании приложения.

7. В мастере создания единицы сохранения состояния нажмите кнопку "Завершить".

   При нажатии кнопки "Завершить" в среде IDE будет создан класс сущностей, который откроется в редакторе. Как видно из примера, в среде IDE было создано поле id private Long id;, и для поля созданы аннотации @Id и @GeneratedValue(strategy = GenerationType.AUTO).

8. В редакторе добавьте поле message (выделено полужирным шрифтом) под полем id.

   private Long id;
   private String message;

9. Правой кнопкой мыши щелкните в области редактора и выберите команду "Вставить код" (CTRL+I), затем выберите "Методы получения и установки".
10. В диалоговом окне "Создание методов получения и установки" выберите поле message и нажмите кнопку "Создать".

    В среде IDE будут созданы методы получения и установки для поля message.

    
11. Сохраните изменения.

Класс сущностей представляет собой таблицу в базе данных. При запуске этого приложения автоматически будет создана таблица базы данных для сообщения. Таблица будет состоять из столбцов id и message.

Если проанализировать единицу сохранения состояния в редакторе XML, можно увидеть, что в приложении используется интерфейс Java Transaction API (JTA) (transaction-type="JTA"). Это указывает на то, что управление жизненным циклом сущностей в контексте сохранения состояния осуществляется контейнером. В результате требуется меньше строк кода, так как жизненный цикл сущностей управляется контейнером, а не приложением. Подробные сведения об использовании JTA для управления транзакциями приведены в документации по интерфейсу Java Transaction API.

Создание фасада сеанса

В этом упражнении будет использоваться мастер создания фасада сеанса без сохранения состояния для сущности Message. Согласно спецификации EJB 3.1. теперь бизнес-интерфейсы для сеансных компонентов не являются обязательными. В этом приложении, где клиент, имеющий доступ к компоненту, является локальным клиентом, для отображения компонента существует возможность использования представления с локальным интерфейсом или без интерфейса.

Для создания сеансного компонента выполните следующие шаги.

1. Щелкните узел проекта правой кнопкой мыши и выберите команду "Создать" > "Другие".
2. Выберите "Сеансные компоненты" для "Классов сущностей" из категории "Java EE". Нажмите кнопку "Далее".
3. Выберите сущность Message и нажмите кнопку "Добавить". Нажмите кнопку "Далее".
4. В поле "Пакет" введите boundary. Нажмите кнопку "Завершить".

   Обратите внимание на то, что создавать бизнес-интерфейс для сеансного компонента не требуется. Вместо этого в данном приложении компонент будет отображаться для локально управляемого компонента в представлении без интерфейса.

   

При нажатии кнопки "Готово" в среде IDE создается класс фасада сеанса MessageFacade.java и AbstractFacade.java, и в редакторе открываются файлы. Аннотация @Stateless, используемая в приведенном созданном коде, служит для объявления класса MessageFacade.java в качестве элемента сеансного компонента без сохранения состояния. Класс MessageFacade.java расширяет класс AbstractFacade.java, содержащий бизнес-логику и управляющий транзакцией.

@Stateless
public class MessageFacade extends AbstractFacade<Message> {
    @PersistenceContext(unitName = "SimpleEE6AppPU")
    private EntityManager em;
            

При создании фасада для сущности с помощью мастера в среде IDE по умолчанию добавляется аннотация PersistenceContext (@PersistenceContext(unitName = "SimpleEE6AppPU")) для ввода ресурса диспетчера сущностей в элемент сеансного компонента и для определения имени единицы сохранения состояния. В этом примере имя единицы сохранения состояния объявлено явно, но имя не является обязательным, если в приложении используется только одна единица сохранения состояния.

Кроме того, среда IDE создает методы в AbstractFacade.java для создания, редактирования, удаления и поиска сущностей. В интерфейсе API EntityManager определяются методы взаимодействия с контекстом сохранения состояния. При этом в среде IDE создается несколько часто используемых методов запроса по умолчанию, которые могут использоваться для поиска объектов сущностей. В методах findAll, findRange и count используются методы, определенные в интерфейсе Criteria API для создания запросов. Интерфейс Criteria API добавлен в спецификацию JPA 2.0 в составе спецификации Java EE 6.

Создание управляемого компонента

В этом упражнении будет создан простой управляемый компонент JSF, используемый для получения доступа к фасаду сеанса. Спецификация JSF 2.0, которая является частью Java EE 6, позволяет использовать аннотации в классе компонента для определения класса в качестве управляемого компонента JSF, указывать контекст и имя компонента.

Для создания управляемого компонента выполните следующие шаги.

1. Щелкните узел проекта правой кнопкой мыши и выберите команду "Создать" > "Другие".
2. Выберите "Управляемый компонент JSF" в категории "JavaServer Faces". Нажмите кнопку "Далее".
3. В поле "Имя класса" введите MessageView.

   Имя управляемого компонента MessageView используется в качестве значения для inputText и commandButton на странице JSF index.xhtml при вызове методов в компоненте.

4. В поле "Пакет" введите my.presentation.
5. В поле "Имя", используемое для управляемого компонента, введите MessageView.

   Примечание. При создании управляемого компонента с помощью мастера компоненту в среде IDE по умолчанию будет присвоено имя на основе имени класса компонента, начинающееся со строчной буквы. Для наглядности присвоим компоненту имя, начинающееся с прописной буквы, явным образом. При ссылке на этот компонент вместо messageView на страницах JSF будет использоваться MessageView. Если имя не присваивается явным образом, по умолчанию на страницах JSF используется messageView.

6. Установите контекст для запроса. Нажмите кнопку "Завершить".

При нажатии кнопки "Завершить" в среде IDE будет создан класс компонента, который откроется в редакторе. В окне "Проекты" выводятся следующие файлы.

В редакторе можно увидеть, что в среде IDE добавлены аннотации @ManagedBean и @RequestScoped и имя компонента.

@ManagedBean(name="MessageView")
@RequestScoped
public class MessageView {

    /** Создает новый экземпляр MessageView */
    public MessageView() {
    }

}

Теперь добавляем аннотацию @EJB для использования учета зависимостей, чтобы получить ссылку на сеансный компонент MessageFacade. Также вызовем методы findAll и create, представленные в фасаде. Автозавершение кода среды IDE помогает при вводе методов.

1. Правой клавишей мыши щелкните в области редактора и выберите команду "Вставить код" (CTRL+I) для открытия всплывающего меню.
2. В всплывающем меню выберите "Вызов компонента EJB".
3. В диалоговом окне "Вызов компонента EJB" выберите MessageFacade. Нажмите кнопку "OК".
   

   При нажатии кнопки "ОК" в среде IDE добавляется следующий код (выделено полужирным шрифтом) для ввода компонента.

   public class MessageView {
   
       /** Создание экземпляра MessageView */
       public MessageView() {
       }
   
       // Ввод компонента сеанса MessageFacade при помощи аннотации @EJB
       @EJB
       private MessageFacade messageFacade;
   }
   

4. Для создания нового экземпляра добавьте следующий код.

   /** Создает новый экземпляр MessageView */
       public MessageView() {
          this.message = new Message();
       }

5. Добавьте следующий код к классу.

       // Создает новое поле
       private Message message;
   
       // Создает новый экземпляр Message
       public MessageView() {
          this.message = new Message();
       }
   
       // Вызывает getMessage для получения сообщения
       public Message getMessage() {
          return message;
       }
   
       // Возвращает общее число сообщений
       public int getNumberOfMessages(){
          return messageFacade.findAll().size();
       }
   
       // Сохраняет сообщение и затем возвращает строку "theend"
       public String postMessage(){
          this.messageFacade.create(message);
          return "theend";
       }
   

6. Исправьте выражения импорта (CTRL+SHIFT+I) и сохраните измененные данные.

Можно использовать автозавершение кода в редакторе, упрощающее ввод кода.

Обратите внимание, что метод postMessage возвращает строку "theend". Спецификация JSF 2.0 позволяет использование имплицитных правил перехода в приложениях, в которых используется технология Facelets. В этом приложении не настроены правила перехода в faces-config.xml. Вместо этого обработчик переходов пытается найти подходящую страницу в приложении. В этом случае обработчик переходов пытается найти страницу с именем theend.xhtml при вызове метода postMessage.

Изменение страницы-указателя

В этом упражнении будет выполнено несколько простых изменений страницы index.xhtml для добавления компонентов пользовательского интерфейса. Выполняется добавление формы с текстовым полем для ввода и кнопкой.

1. Откройте в редакторе index.xhtml.
2. Измените файл для добавления следующей простой формы между тегами <h:body>.

   <h:body>
       <f:view>
           <h:form>
               <h:outputLabel value="Message:"/><h:inputText value="#{MessageView.message.message}"/>
               <h:commandButton action="#{MessageView.postMessage}" value="Post Message"/>
           </h:form>
       </f:view>
   </h:body>

   Автозавершение кода JSF может помочь при вводе кода.

   
3. Сохраните изменения.

Компоненты inputText и commandButton вызывают методы в управляемом компоненте JSF с именем MessageView. Метод postMessage возвращает "theend", а обработчик переходов выполняет поиск страницы с именем theend.xhtml.

Создание страницы результатов

В этом упражнении будет создана страница JSF theend.xhtml. Эта страница будет отображаться при нажатии пользователем кнопки "Отправить сообщение" в index.xhtml и при вызове метода postMessage в управляемом компоненте JSF.

1. Щелкните узел проекта правой кнопкой мыши и выберите команду "Создать" > "Другие".
2. В категории "JavaServer Faces" выберите "Страница JSF". Нажмите кнопку "Далее".
3. В поле "Имя файла" введите theend.
4. Убедитесь, что выбран параметр Facelets. Нажмите кнопку "Завершить".
5. Измените файл посредством ввода следующего кода между тегов <h:body>.

   <h:body>
       <h:outputLabel value="Thanks! There are "/>
       <h:outputText value="#{MessageView.numberOfMessages}"/>
       <h:outputLabel value=" messages!"/>
   </h:body>

В начале ввода в среде IDE автоматически добавляется определение библиотеки тегов xmlns:h="http://java.sun.com/jsf/html к файлу для элементов JSF.