Создание класса Java "Person"

1. Щелкните правой кнопкой мыши узел "Source Packages" в окне "Projects" и выберите "New > Java Class" для открытия мастера создания класса Java.
2. В мастере введите имя класса Person и пакет travel. Нажмите кнопку "Finish".
3. Внесите в класс следующие изменения (выделены полужирным шрифтом) для реализации интерфейса "Serializable" и добавьте поля для столбцов таблицы.

   public class Person implements Serializable {
       private int personId;
       private String name;
       private String jobTitle;
       private boolean frequentFlyer;
       private java.util.Set trips;
   }

4. Для создания методов получения и установки для полей щелкните правой кнопкой мыши в редакторе исходного кода, выберите "Insert Code" (Alt-Insert), а затем выберите "Getter and Setter".
5. В диалоговом окне "Generate Getters and Setters" выберите все поля и нажмите кнопку "Generate".
   

   В диалоговом окне "Generate Getters and Setters" для перемещения выбранного элемента к элементу "Person" можно использовать стрелку вверх на клавиатуре, а затем нажать клавишу "пробел" и выбрать все поля в "Person".

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

Создание класса Java "Trip"

1. Щелкните правой кнопкой мыши узел "Source Packages" в окне "Projects" и выберите "New > Java Class" для открытия мастера создания класса Java.
2. В мастере введите имя класса Trip и пакет travel. Нажмите кнопку "Finish".
3. Внесите в класс следующие изменения (выделены полужирным шрифтом) для реализации интерфейса "Serializable" и добавьте поля для столбцов таблицы.

   public class Trip implements Serializable {
       private int tripId;
       private int personId;
       private Date depDate;
       private String depCity;
       private String destCity;
       private int tripTypeId;
   }

4. Для создания методов получения и установки для полей щелкните правой кнопкой мыши в редакторе исходного кода, выберите "Insert Code" (Alt-Insert), а затем выберите "Getter and Setter".
5. В диалоговом окне "Generate Getters and Setters" выберите все поля и нажмите кнопку "Generate".
6. Исправьте операторы импорта и сохраните изменения.

Person.java и Trip.java можно закрыть, т.к. необходимость в их изменении отсутствует.

Отображение Person.java на таблицу PERSON

Сначала создайте файл отображения библиотеки Hibernate Person.hbm.xml для отображения полей Person.java на столбцы в таблице PERSON.

1. Запустите сервер базы данных JavaDB, если он еще не запущен.
2. В окне "Projects" щелкните правой кнопкой мыши узел "Travel" под "Source Packages" и выберите "New > Other" в контекстном меню для открытия мастера создания файла.
3. Выберите "Hibernate" из списка "Categories" и "Hibernate Mapping File" из списка "File Types". Нажмите кнопку "Next".
4. Введите имя файла Person.hbm и установите папку src/java/travel. Нажмите кнопку "Next".
5. Введите travel.Person для "Class to Map".

   Примечание: В качестве альтернативы можно нажать кнопку "Browse" и ввести "Person" в диалоговом окне "Find Type".

6. Выберите PERSON из раскрывающегося списка "Database Table".

   Примечание: Если раскрывающийся список "Database Table" пуст, то скорее всего это означает, что база данных не запущена. Можно продолжить создание файла без указания таблицы, но в дальнейшем потребуется определить таблицу в XML.

7. Нажмите кнопку "Finish".

   После нажатия кнопки "Finish" средой IDE создается файл Person.hbm.xml в том же самом исходном пакете, что и файл Person.java. Этот файл открывается в редакторе. По умолчанию файл XML выглядит следующим образом:

   <hibernate-mapping>
     <class dynamic-insert="false" dynamic-update="false" mutable="true"
     name="travel.Person" optimistic-lock="version" polymorphism="implicit"
     select-before-update="false" table="PERSON"/>
   </hibernate-mapping>

   Примечание: При невозможности выбрать таблицу PERSON в раскрывающемся списке при создании файла убедитесь, что к элементу class добавлена запись table="PERSON".

8. В редакторе XML внесите следующие изменения (выделены полужирным шрифтом) для отображения идентификатора, свойств и связи "один ко многим".

   <hibernate-mapping>
     <class dynamic-insert="false" dynamic-update="false"
         mutable="true" name="travel.Person" optimistic-lock="version"
         polymorphism="implicit" select-before-update="false" table="PERSON">
           <id column="PERSONID" name="personId">
               <generator class="increment"/>
           </id>
           <property column="NAME" name="name"/>
           <property column="JOBTITLE" name="jobTitle"/>
           <property column="FREQUENTFLYER" name="frequentFlyer"/>
           <set cascade="all-delete-orphan" inverse="true" lazy="true" name="trips" table="TRIP">
               <key column="PERSONID"/>
               <one-to-many class="travel.Trip"/>
           </set>
       </class>
   </hibernate-mapping>

   Для добавления свойств и значений в редакторе XML можно воспользоваться функцией автозавершения кода. Если автозавершение кода не работает так, как показано на этом примере экрана, то см. примечание ниже.

   

   Примечание: По умолчанию элемент class содержит закрывающий тег. Поскольку необходимо добавить элементы свойства между открывающим и закрывающим элементами class, то должны быть внесены следующие изменения (выделены полужирным шрифтом). После внесения изменений можно использовать автозавершение кода между элементами class.

   <hibernate-mapping>
     <class dynamic-insert="false" dynamic-update="false"
     mutable="true" name="travel.Person" optimistic-lock="version"
     polymorphism="implicit" select-before-update="false" table="PERSON">
   
     </class>
   </hibernate-mapping>

9. Проверьте корректность XML, устраните любые обнаруженные ошибки и сохраните файл.

Отображение Trip.java на таблицу TRIP

Теперь необходимо создать файл отображения библиотеки Hibernate Trip.hbm.xml для отображения полей Trip.java на столбцы в таблице TRIP.

1. В окне "Projects" щелкните правой кнопкой мыши узел "Travel" под "Source Packages" и выберите "New > Other" в контекстном меню для открытия мастера создания файла.
2. Выберите "Hibernate" из списка "Categories" и "Hibernate Mapping File" из списка "File Types". Нажмите кнопку "Next".
3. Введите имя файла Trip.hbm и укажите папку src/java/travel. Нажмите кнопку "Next".
4. Введите travel.Trip для "Class to Map".

   Примечание: В качестве альтернативы можно нажать кнопку "Browse" и ввести "Trip" в диалоговом окне "Find Type".

5. Выберите "TRIP" из раскрывающегося списка "Database Table".

   Примечание: Если раскрывающийся список "Database Table" пуст, то оставьте его пустым. Имя таблицы можно ввести позже в редакторе XML.

6. Нажмите кнопку "Finish".

   После нажатия кнопки "Finish" средой IDE создается файл Trip.hbm.xml в той же самой папке, что и класс Trip.java. Этот файл открывается в редакторе.

7. Внесите в следующие изменения в редакторе XML (выделены полужирным шрифтом).

   <hibernate-mapping>
           <class dynamic-insert="false" dynamic-update="false" mutable="true"
               name="travel.Trip" optimistic-lock="version" polymorphism="implicit"
               select-before-update="false" table="TRIP">
   	<id column="TRIPID" name="tripId">
               <generator class="increment"/>
           </id>
           <property column="PERSONID" name="personId"/>
           <property column="DEPDATE" name="depDate" type="date"/>
           <property column="DEPCITY" name="depCity"/>
           <property column="DESTCITY" name="destCity"/>
           <property column="TRIPTYPEID" name="tripTypeId"/>
       </class>
   </hibernate-mapping>

   Для добавления свойств и значений в редакторе XML воспользуйтесь функцией автозавершения кода.

8. Проверьте корректность XML, устраните любые обнаруженные ошибки и сохраните файл.

Добавление элементов визуального веб-приложения JSF к странице

1. Разверните папку "Web Pages" в окне "Projects" и откройте файл Page1.jsp в Visual Designer.
2. Перетащите элемент "Drop Down List" из набора элементов "Woodstock Basic" в палитре в верхний левый угол страницы "Page1".
3. Щелкните правой кнопкой мыши элемент "Drop Down List" и выберите "Auto-Submit on Change" в контекстном меню.

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

4. Снова щелкните правой кнопкой мыши элемент "Drop Down List" и выберите "Add Binding Attribute".

   Примечание: Указание привязок свойств будет рассмотрено далее в этом руководстве. В среде IDE NetBeans 6.1 поддерживается привязка по запросу. В тех местах, где элементы требуют написания кода Java, следует вручную добавить атрибут привязки к элементам в визуальном веб-приложении JSF. Для этого щелкните правой кнопкой мыши каждый элемент и выберите "Add Binding Attribute". Для получения дополнительных сведений см. вики-страницу On-demand Binding Attribute.

5. Перетащите элемент "Table" под элемент "Drop Down List".
6. Перетащите элемент "Message Group" под элемент "Table".

   Элементы "Message Group" помогают диагностировать проблемы на этапе выполнения. По умолчанию элемент "Message Group" выводит на экран сообщения об ошибках во время выполнения программы, ошибках проверки достоверности и ошибках преобразования.

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

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

Обращение к источнику данных из SessionBean1

Теперь для получения доступа к источнику данных необходимо изменить компонент "SessionBean1". В этом упражнении для указания полей в компоненте "SessionBean1" и создания методов получения и установки для полей используется диалоговое окно "Add Property". Сеансный компонент открывает контекст сеанса и затем получает данные через объекты Java.

1. Разверните пакет исходных файлов hibernatetravelapp в окне "Projects" и дважды щелкните SessionBean1.java для открытия файла в редакторе.
2. Поместите курсор в пустом пространстве в исходном коде (например, справа после конструктора), щелкните правой кнопкой мыши и выберите "Insert Code > Add Property" (Ctrl-I) для открытия диалогового окна "Add Property".
3. В диалоговом окне "Add Property" введите personOptions в поле "Name", Option[] в поле "Type" и выберите private.
4. Выберите пункт "Generate Getters and Setters", если он еще не выбран. Нажмите кнопку "OK".
   
5. Повторите эти действия для добавления следующих свойств:

   Name	Type
   selectedPersonId	Integer
   trips4Person	Trip[]

   
6. Добавьте методы buildPersonOptions и updateTrips4Person к классу путем добавления следующего кода (выделен полужирным шрифтом) к компоненту "SessionBean1" после метода getApplicationBean1.

   protected ApplicationBean1 getApplicationBean1() {
           return (ApplicationBean1) getBean("ApplicationBean1");
       }
   
   private void buildPersonOptions() {
       List<Person> personList = null;
       try{
           Session session = HibernateUtil.getSessionFactory().getCurrentSession();
           Transaction tx = session.beginTransaction();
           Query q = session.createQuery("from Person");
           personList = (List<Person>) q.list();
   
       } catch(Exception e) {
           e.printStackTrace();
       }
   
       personOptions = new Option[personList.size()];
       int i=0;
       for(Person person : personList) {
           Option opt = new Option(person.getPersonId(), person.getName());
           personOptions[i++] = opt;
       }
   }
   
   private void updateTrips4Person() {
       if(selectedPersonId == null ) {
           trips4Person = new Trip[1];
           trips4Person[0] = new Trip();
           return;
       }
   
       Set personTrips = null;
       try{
          Session session =
                   HibernateUtil.getSessionFactory().getCurrentSession();
           Transaction tx = session.beginTransaction();
           Person person = (Person)session.load(Person.class, selectedPersonId);
           personTrips = (PersistentSet)person.getTrips();
   
       } catch(Exception e) {
           e.printStackTrace();
       }
   
       trips4Person = (Trip[]) personTrips.toArray(new Trip[0]);
   }

   Метод buildPersonOptions вызывает запрос к источнику данных "Person" и сохраняет результаты в массиве personOptions. Метод updateTrips4Person обновляет поездки для выбранного лица.

7. Исправьте операторы импорта.
   

   Примечание: При выборе полностью определенных имен для импорта убедитесь, что выбраны библиотеки org.hibernate и com.sun.webui.jsf.model.Option и java.util.Set.

8. Вызовите метод buildPersonOptions путем добавления следующего кода (выделен полужирным шрифтом) в конец метода init().

   @Override
   public void init() {
       super.init();
   
       try {
           _init();
       } catch (Exception e) {
           log("SessionBean1 Initialization Failure", e);
           throw e instanceof FacesException ? (FacesException) e : new FacesException(e);
       }
       // Fill in the personOptions[]
       buildPersonOptions();
   
   }

9. Вызовите метод updateTrips4Person путем добавления следующего кода (выделен полужирным шрифтом) в конец метода setSelectedPersonId.

   public void setSelectedPersonId(Integer selectedPersonId) {
       this.selectedPersonId = selectedPersonId;
       updateTrips4Person();
   }

10. Сохраните изменения.
11. Щелкните правой кнопкой мыши узел проекта в окне "Projects" и выберите "Build".

Привязка компонентов к данным

В этом разделе описана процедура связывания элементов "Drop Down List" и "Table" на веб-странице со свойствами, определенными в предыдущем разделе в компоненте "SessionBean1".

1. Откройте Page1.jsp в Visual Designer.
2. Щелкните правой кнопкой мыши элемент "Drop Down List" и выберите "Property Bindings" для открытия диалогового окна "Property Bindings".
3. Выберите items в списке свойств "Bindable" и personOptions (под узлом "SessionBean1") в списке целевых элементов привязки. Нажмите кнопку "Apply".
   
4. В том же самом диалоговом окне выберите selected в списке свойств "Bindable" и selectedPersonId (под узлом "SessionBean1") в списке целей "Binding". Нажмите кнопку "Apply".
   
5. Для закрытия диалогового окна нажмите кнопку "Close".
6. В Visual Designer щелкните правой кнопкой мыши элемент "Table" и выберите "Table Layout".
7. В диалоговом окне выберите trips4Person (SessionBean1) из раскрывающегося списка "Get Data From".
   

   Примечание: Если "trips4Person" ("SessionBean1") отсутствует в раскрывающемся списке, то скорее всего сборка проекта в конце предыдущего раздела не была выполнена.

8. Выберите personId в списке "Selected" и нажмите кнопку со стрелкой влево для перемещения поля из списка "Selected" в список "Available".
9. Используйте кнопки со стрелками вверх и вниз для размещения оставшихся полей в порядке, показанном ниже, после чего нажмите кнопку "OK".
   
10. На панели инструментов "Editing" нажмите кнопку "Java" для открытия Page1.java в редакторе Java.
11. В методе prerender добавьте следующий код (выделен полужирным шрифтом).

    public void prerender() {
        try {
            if (dropDown1.getSelected() == null ) {
                Option firstPerson = getSessionBean1().getPersonOptions()[0];
                getSessionBean1().setSelectedPersonId((Integer)firstPerson.getValue());
            }
        } catch (Exception ex) {
            log("Error Description", ex);
            error(ex.getMessage());
        }
    }

    Код в методе prerender вызывается до начала вывода страницы веб-обозревателем. Добавление кода к методу prerender приводит к отображению на странице информации для первого пользователя в раскрывающемся списке при первом посещении страницы пользователем.

    При первом запросе страницы обозревателем в приложении создается экземпляр Page1 и вызывается метод prerender. Сервер передает ответ (страницу HTML), и экземпляр Page1 уничтожается. Приложение не вызывает обработчик события изменения значения, поскольку события изменения значения создаются только при передаче страницы (в данном случае – при выборе нового лица).

12. Щелкните правой кнопкой мыши в исходном коде и выберите "Fix Imports" в контекстном меню для открытия диалогового окна "Fix Imports". В раскрывающемся списке "Fully Qualified Name" выберите com.sun.webui.jsf.model.Option, как показано ниже.
    
13. Сохраните изменения.