Создание файла обратного проектирования платформы Hibernate

При необходимости использования файлов отображения платформы Hibernate и объектов POJO в мастере "Базы данных" необходимо сначала создать файл обратного проектирования hibernate.reveng.xml. Для файлов отображения платформы Hibernate и объектов POJO в мастере "Базы данных" требуются файлы hibernate.reveng.xml и hibernate.cfg.xml.

Файл обратного проектирования помогает лучше управлять стратегиями сопоставления баз данных. Мастер "Обратное проектирование Hibernate" создает файл обратного проектирования с параметрами настройки по умолчанию, которые можно изменить в редакторе XML.

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

1. Щелкните правой кнопкой мыши узел "Исходные файлы" в окне "Проекты" и выберите команду "Создать > Прочее" для открытия мастера создания файла "Новый файл".
2. Выберите "Мастер обратного проектирования Hibernate" в категории "Hibernate". Нажмите кнопку "Далее".
3. Укажите hibernate.reveng в качестве имени файла и src/java в качестве имени папки. Нажмите кнопку "Далее".
4. Выберите hibernate.cfg.xml из раскрывающегося списка "Файл конфигурации", если это значение не было выбрано ранее.
5. Выберите следующие таблицы в поле "Доступные таблицы" и нажмите "Добавить" для добавления этих таблиц в область "Выбранные таблицы".
   • actor
   • category
   • film
   • film_actor
   • film_category
   • language

   Нажмите кнопку "Готово".

   

Мастер создает файл обратного проектирования hibernate.reveng.xml и открывает файл в редакторе. Файл обратного проектирования можно закрыть, поскольку его изменение не требуется.

Дополнительные сведения о работе с файлом hibernate.reveng.xml можно найти в главе 5. Управление обратным проектированием документа Справочник по средствам Hibernate

Создание файлов отображения платформы Hibernate и объектов POJO

Для создания файлов можно использовать файлы отображения платформы Hibernate и объекты POJO в мастере "Базы данных". Мастер может создать объект POJO и соответствующий файл отображения для каждой таблицы, выбранной в мастере. Файлы отображения являются файлами XML, содержащими данные об отображении столбцов таблиц в полях в объектах POJO. Для использования мастера необходимы файлы hibernate.reveng.xml и hibernate.cfg.xml.

Для создания объектов POJO и файлов отображения с помощью мастера выполните следующие шаги.

1. Щелкните правой кнопкой мыши узел "Исходные файлы" в окне "Проекты" и выберите команду "Создать > Прочее" для открытия мастера создания файла "Новый файл".
2. Выберите "Файлы сопоставления Hibernate и объекты POJO из базы данных" в категории "Hibernate". Нажмите кнопку "Далее".
3. Убедитесь, что в раскрывающихся списках выбраны файлы hibernate.cfg.xml и hibernate.reveng.xml.
4. Выберите Функции языка JDK 5 в параметрах "Обычные параметры".
5. Убедитесь в том, что выбраны параметры Код домена и Отображения XML Hibernate.
6. Выберите dvdrental в качестве имени пакета. Нажмите кнопку "Готово".
   

При нажатии кнопки "Готово" в среде IDE создаются объекты POJO и файлы отображения платформы Hibernate где поля отображаются на столбцы, указанные в hibernate.reveng.xml. Среда IDE добавляет записи отображения в файл hibernate.cfg.xml.

<hibernate-configuration>
  <session-factory>
    <property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>
    <property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
    <property name="hibernate.connection.url">jdbc:mysql://localhost:3306/sakila</property>
    <property name="hibernate.connection.username">myusername</property>
    <property name="hibernate.connection.password">mypassword</property>
    <property name="hibernate.show_sql">true</property>
    <property name="hibernate.current_session_context_class">thread</property>
    <property name="hibernate.query.factory_class">org.hibernate.hql.classic.ClassicQueryTranslatorFactory</property>
    <mapping resource="dvdrental/FilmActor.hbm.xml"/>
    <mapping resource="dvdrental/Language.hbm.xml"/>
    <mapping resource="dvdrental/Film.hbm.xml"/>
    <mapping resource="dvdrental/Category.hbm.xml"/>
    <mapping resource="dvdrental/Actor.hbm.xml"/>
    <mapping resource="dvdrental/FilmCategory.hbm.xml"/>
  </session-factory>
</hibernate-configuration>

Примечание. Убедитесь, в том, что элементы сопоставления перечислены в списке после элементов свойства в файле hibernate.cfg.xml.

Можно развернуть пакет dvdrental для просмотра файлов, созданных с помощью мастера.

Можно использовать мастер "Отображение Hibernate" для создания файла отображения платформы Hibernate, отображающего определенную таблицу на определенный класс.

Дополнительные сведения о работе с файлом hibernate.reveng.xml можно найти в главе 5. Отображение O/R в Справочной документации по Hibernate.

Создание класса

В этом разделе будет использован мастер создания файла для создания служебного класса FilmHelper.java в пакете dvdrental. Будут созданы сеансы Hibernate с помощью вызова getSessionFactory в HibernateUtil.java и некоторые служебные методы создания запросов для извлечения данных из базы данных. Также будут вызваны служебные методы из страниц JSP.

1. Щелкните правой кнопкой мыши узел исходных файлов dvdrental и выберите "Создать > Класс Java" для открытия мастера создания файла.
2. Введите FilmHelper в качестве имени класса.
3. Убедитесь в том, что в качестве пакета выбран dvdrental. Нажмите кнопку "Готово".
4. Добавьте следующий код (выделенный полужирным шрифтом) для создания сеанса Hibernate.

   public class FilmHelper {
   
       Session session = null;
   
       public FilmHelper() {
           this.session = HibernateUtil.getSessionFactory().getCurrentSession();
       }
   
   }

5. Щелкните правой кнопкой мыши в редакторе и выберите команду "Исправить операторы импорта" (ALT+SHIFT+I; &#8984+SHIFT+I на компьютере Mac) для добавления любого необходимого оператора импорта (org.hibernate.Session) и сохраните изменения.

Теперь можно изменить класс FilmHelper.java для добавления методов, выполняющих запрос данных в БД.

Перечисление названий фильмов и извлечение актеров с помощью запроса HQL.

В этом упражнении будет показано, как создать запрос на языке запросов Hibernate (HQL), обеспечивающий извлечение из базы данных списка названий фильмов из таблицы "Film". Затем добавляется метод, запрашивающий одновременно таблицы "Actor" и "Film_actor" для выбора актеров, снимавшихся в определенном фильме.

Таблица "Film" содержит 1000 записей, в связи с чем метод извлечения списка фильмов должен извлекать записи, основываясь на первичном ключе filmId. Для создания и тестирования запроса HQL необходимо использовать редактор HQL. После создания корректного запроса нужно добавить метод к классу, способному создать соответствующий запрос.

1. В окне "Проекты" щелкните правой кнопкой мыши и выберите команду "Очистка и сборка".
2. Щелкните правой кнопкой мыши hibernate.cfg.xml в окне "Проекты" и выберите "Выполнить запрос HQL" для открытия редактора запросов HQL.
3. Выберите "hibernate.cfg" из раскрывающегося списка на панели инструментов.
4. Протестируйте соединение путем ввода следующего текста в редакторе и нажатия кнопки "Выполнить запрос HQL" ( ) на панели инструментов.

   from Film

   После нажатия кнопки "Выполнить запрос HQL" результаты выполнения запроса отображаются в нижней части редактора запросов HQL.

   

   При нажатии кнопки "SQL" на экране должен отобразиться эквивалентный запрос SQL.

   select film0_.film_id as col_0_0_ from sakila.film film0_

5. Введите следующий запрос на извлечение из таблицы "Film" записей, в которых идентификатор фильма находится между 100 и 200.

   from Film as film where film.filmId between 100 and 200

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

6. Добавьте следующий метод getFilmTitles к FilmHelper.java для извлечения фильмов с идентификатором, находящимся в определенном диапазоне, ограниченном переменными startID и endID.

   public List getFilmTitles(int startID, int endID) {
       List<Film> filmList = null;
       try {
           org.hibernate.Transaction tx = session.beginTransaction();
           Query q = session.createQuery ("from Film as film where film.filmId between '"+startID+"' and '"+endID+"'");
           filmList = (List<Film>) q.list();
       } catch (Exception e) {
           e.printStackTrace();
       }
       return filmList;
   }

7. Добавьте следующий метод getActorsByID для извлечения актеров, задействованных в определенном фильме. Для создания запроса в этом методе в качестве входной переменной используется filmId.

   public List getActorsByID(int filmId){
       List<Actor> actorList = null;
       try {
           org.hibernate.Transaction tx = session.beginTransaction();
           Query q = session.createQuery ("from Actor as actor where actor.actorId in (select filmActor.actor.actorId from FilmActor as filmActor where filmActor.film.filmId='" + filmId + "')");
           actorList = (List<Actor>) q.list();
   
       } catch (Exception e) {
           e.printStackTrace();
       }
   
       return actorList;
   }

8. Исправьте параметры импорта и сохраните измененные данные.

   После исправления параметров импорта выберите java.util.List и org.hibernate.Query.

Добавление вспомогательных служебных методов.

Теперь перейдем к добавлению вспомогательных служебных методов, создающих запросы на основе входной переменной. Запросы можно проверить в редакторе запросов HQL.

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

   public Category getCategoryByID(int filmId){
       List<Category> categoryList = null;
       try {
           org.hibernate.Transaction tx = session.beginTransaction();
           Query q = session.createQuery("from Category as category where category.categoryId in (select filmCat.category.categoryId from FilmCategory as filmCat where filmCat.film.filmId='" + filmId + "')");
           categoryList = (List<Category>) q.list();
   
       } catch (Exception e) {
           e.printStackTrace();
       }
   
       return categoryList.get(0);
   }

2. Добавьте следующий метод для извлечения отдельного фильма согласно filmId.

   public Film getFilmByID(int filmId){
   
       Film film = null;
   
       try {
           org.hibernate.Transaction tx = session.beginTransaction();
           Query q = session.createQuery("from Film as film where film.filmId=" + filmId);
           film = (Film) q.uniqueResult();
       } catch (Exception e) {
           e.printStackTrace();
       }
   
       return film;
   }

3. Добавьте следующий метод для извлечения языка фильма согласно langId.

   public String getLangByID(int langId){
   
       Language language = null;
   
       try {
           org.hibernate.Transaction tx = session.beginTransaction();
           Query q = session.createQuery("from Language as lang where lang.languageId=" + langId);
           language = (Language) q.uniqueResult();
       } catch (Exception e) {
           e.printStackTrace();
       }
   
       return language.getName();
   }

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

Создание template.xhtml

Сначала необходимо создать шаблон JSF Facelets template.xhtml, используемый в страницах index.xhtml и browse.xhtml.

1. Щелкните узел проекта DVDStore правой кнопкой мыши в окне "Проекты" и выберите команду "Создать" > "Другое".
2. Выберите "Шаблон Facelets" в категории "JavaServer Faces". Нажмите кнопку "Далее".
3. Введите template в качестве имени файла и выберите первый стиль формата CSS.
4. Нажмите кнопку "Готово".

   При нажатии кнопки "Готово" файл template.xhtml открывается в редакторе. Шаблон содержит следующий код по умолчанию.

   <h:body>
   
       <div id="top" class="top">
           <ui:insert name="top">Наверх</ui:insert>
       </div>
   
       <div id="content" class="center_content">
           <ui:insert name="content">Содержимое</ui:insert>
       </div>
   
   </h:body>

5. Измените элемент <ui:insert> для изменения созданного по умолчанию имени на "body".

   <div id="content" class="center_content">
           <ui:insert name="body">Содержимое</ui:insert>
   </div>

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

Содержимое, заключенное в элементе <ui:define name="body"> в файлах index.xhtml и browse.xhtml, будет вставлено в местоположение, определенное в шаблоне с помощью <ui:insert name="body">Content</ui:insert>.

Изменение index.xhtml

При создании веб-приложения автоматически создается страница index.xhtml. В этом упражнении страница будет изменена для отображения списка названий фильмов. Страница JSF вызывает методы в управляемом компоненте JSF "FilmController" для извлечения списка фильмов, а затем выводит таблицу с названиями и описаниями фильмов.

1. Разверните папку "Веб-страницы" в окне "Проекты" и откройте файл index.xhtml в редакторе.

   Мастер создания нового проекта создает следующую страницу по умолчанию index.xhtml.

   <html xmlns="http://www.w3.org/1999/xhtml"
         xmlns:h="http://java.sun.com/jsf/html">
   <h:head>
           <title>Заголовок Facelet</title>
       </h:head>
       <h:body>
           Привет от Facelets
       </h:body>
   </html>

2. Измените страницу для использования элементов JSF <ui:composition> и <ui:define> и добавьте элемент <h:form>.

   <html xmlns="http://www.w3.org/1999/xhtml"
     xmlns:h="http://java.sun.com/jsf/html"
     xmlns:ui="http://java.sun.com/jsf/facelets">
       <ui:composition template="./template.xhtml">
           <ui:define name="body">
               <h:form>
   
               </h:form>
           </ui:define>
       <ui:composition>
   </html>

   При вводе тегов среда IDE добавляет объявление библиотеки тегов xmlns:ui="http://java.sun.com/jsf/facelets".

   Элементы <ui:composition> и <ui:define> используются в сочетании с созданным шаблоном страницы. Элемент <ui:composition> ссылается на местоположение шаблона, используемого этой страницей. Элемент <ui:define> ссылается на позицию в шаблоне, занятую вложенным кодом.

3. Добавьте следующие ссылки перехода, вызывающие методы next и previous в управляемом компоненте JSF.

       <ui:define name="body">
               <h:form>
                   <h:commandLink action="#{filmController.previous}" value="Предыдущие #{filmController.pageSize}" rendered="#{filmController.hasPreviousPage}"/> 
                   <h:commandLink action="#{filmController.next}" value="Следующие #{filmController.pageSize}" rendered="#{filmController.hasNextPage}"/> 
               </h:form>
       </ui:define>

4. Добавьте следующий элемент (выделенный полужирным шрифтом) dataTable для создания таблицы, в которой будут отображены извлеченные элементы.

               <h:form styleClass="jsfcrud_list_form">
                   <h:commandLink action="#{filmController.previous}" value="Previous #{filmController.pageSize}" rendered="#{filmController.hasPreviousPage}"/> 
                   <h:commandLink action="#{filmController.next}" value="Next #{filmController.pageSize}" rendered="#{filmController.hasNextPage}"/> 
                   <h:dataTable value="#{filmController.filmTitles}" var="item" border="0" cellpadding="2" cellspacing="0" rowClasses="jsfcrud_odd_row,jsfcrud_even_row" rules="all" style="border:solid 1px">
                       <h:column>
                           <f:facet name="header">
                               <h:outputText value="Название"/>
                           </f:facet>
                           <h:outputText value="#{item.title}"/>
                       </h:column>
                       <h:column>
                           <f:facet name="header">
                               <h:outputText value="Описание"/>
                           </f:facet>
                           <h:outputText value="#{item.description}"/>
                       </h:column>
                       <h:column>
                           <f:facet name="header">
                               <h:outputText value=" "/>
                           </f:facet>
                           <h:commandLink action="#{filmController.prepareView}" value="Просмотр"/>
                       </h:column>
                   </h:dataTable>
                   <br/>
               </h:form>
   

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

Теперь на начальной странице отображается список названий фильмов из базы данных. Каждая строка в таблице содержит ссылку "Просмотр", вызывающую метод prepareView в управляемом компоненте. Метод prepareView возвращает "browse" и открывает файл browse.xhtml.

Примечание. При вводе тега <f:facet> среда IDE добавит объявление xmlns:f="http://java.sun.com/jsf/core библиотеки тегов. Убедитесь в том, что в файле объявлена библиотека тегов.

Создание browse.xhtml

Создадим страницу browse.xhtml для отображения дополнительных сведений о выбранном фильме. Для создания страницы на основе созданного шаблона JSF Facelets template.xhtml можно использовать мастер создания клиента шаблона Facelets .

1. Щелкните узел проекта DVDStore правой кнопкой мыши в окне "Проекты" и выберите команду "Создать" > "Другое".
2. Выберите "Клиент шаблона Facelets" в категории "JavaServer Faces". Нажмите кнопку "Далее".
   
3. Введите browse в качестве имени файла.
4. Чтобы найти шаблон для страницы, откройте диалоговое окно "Обзор файлов", нажав кнопку "Ещё".
5. Разверните папку "Веб-страницы" и выберите template.xhtml. Нажмите "Выбрать файл".
   
6. Выберите<ui:composition> в качестве созданного тега корня. Нажмите кнопку "Готово".

   При нажатии кнопки "Готово" файл browse.xhtml открывается в редакторе со следующим кодом.

   <ui:composition xmlns:ui="http://java.sun.com/jsf/facelets"
       template="./template.xhtml">
   
       <ui:define name="top">
           top
       </ui:define>
   
       <ui:define name="body">
           body
       </ui:define>
   
   </ui:composition>

   В новом файле указан файл template.xhtml, а тег <ui:define> обладает свойством name="body"

7. Добавьте следующий код (выделенный полужирным шрифтом) между тегами <ui:define> для создания формы и вызовите методы в управляемом компоненте "FilmController" для извлечения данных и заполнения формы.

   <ui:composition xmlns:ui="http://java.sun.com/jsf/facelets"
       template="./template.xhtml"
       xmlns:h="http://java.sun.com/jsf/html"
       xmlns:f="http://java.sun.com/jsf/core">
   
           <ui:define name="top">
               top
           </ui:define>
   
           <ui:define name="body">
           
               <h:form>
                   <h:panelGrid columns="2">
                       <h:outputText value="Title:"/>
                       <h:outputText value="#{filmController.selected.title}" title="Title"/>
                       <h:outputText value="Description"/>
                       <h:outputText value="#{filmController.selected.description}" title="Description"/>
                       <h:outputText value="Genre"/>
                       <h:outputText value="#{filmController.category}"/>
   
                       <h:outputText value="Cast"/>
                       <h:outputText value="#{filmController.actors}"/>
   
   
                       <h:outputText value="Film Length"/>
                       <h:outputText value="#{filmController.selected.length} min" title="Film Length"/>
   
                       <h:outputText value="Language"/>
                       <h:outputText value="#{filmController.language}" title="Film Length"/>
   
                       <h:outputText value="Release Year"/>
                       <h:outputText value="#{filmController.selected.releaseYear}" title="Release Year">
                           <f:convertDateTime pattern="MM/dd/yyyy" />
                       </h:outputText>
                       <h:outputText value="Rental Duration"/>
                       <h:outputText value="#{filmController.selected.rentalDuration}" title="Rental DUration"/>
                       <h:outputText value="Rental Rate"/>
                       <h:outputText value="#{filmController.selected.rentalRate}" title="Rental Rate"/>
                       <h:outputText value="Replacement Cost"/>
                       <h:outputText value="#{filmController.selected.replacementCost}" title="Replacement Cost"/>
                       <h:outputText value="Rating"/>
                       <h:outputText value="#{filmController.selected.rating}" title="Rating"/>
                       <h:outputText value="Special Features"/>
                       <h:outputText value="#{filmController.selected.specialFeatures}" title="Special Features"/>
                       <h:outputText value="Last Update"/>
                       <h:outputText value="#{filmController.selected.lastUpdate}" title="Last Update">
                           <f:convertDateTime pattern="MM/dd/yyyy HH:mm:ss" />
                       </h:outputText>
                   </h:panelGrid>
                   <br/>
                   <br/>
                   <h:commandLink action="#{filmController.prepareList}" value="View All List"/>
                   <br/>
               </h:form>
   
           </ui:define>
       </ui:composition>
   </html>

   Файлы browse.xhtml и index.xhtml используют один и тот же шаблон страницы.

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