• В состав пакета Java EE среды IDE NetBeans также входит сервер GlassFish, совместимый с Java EE 6, который используется далее в учебном курсе.
• Для проекта решения в этом учебном курсе загрузите ConsultingAgencyJSF20.zip

<h:outputStylesheet name="css/jsfcrud.css"/>

<application>
    <resource-bundle>
        <base-name>/resources/Bundle</base-name>
        <var>bundle</var>
    </resource-bundle>
</application>

Изучение выполненного проекта

1. Для выполнения проекта щелкните правой кнопкой мыши узел проекта в окне "Проекты" и выберите команду "Выполнить" или в главной панели инструментов нажмите кнопку "Выполнить проект" ().
   
   При отображении страницы приветствия приложения выводится список ссылок, позволяющих просмотреть записи, которые включены в каждую таблицу базы данных.
   
   После завершения выполнения всех шагов мастера создания страниц JSF из классов сущностей ссылки добавлены на страницу приветствия (index.xhtml). Они представлены в качестве точек входа на страницы Facelets, обеспечивающие функциональность CRUD в базе данных "Консультационное агентство".

   <h:body>
       Hello from Facelets
       <h:form>
           <h:commandLink action="/address/List" value="Show All Address Items"/>
       </h:form>
       <h:form>
           <h:commandLink action="/billable/List" value="Show All Billable Items"/>
       </h:form>
       <h:form>
           <h:commandLink action="/client/List" value="Show All Client Items"/>
       </h:form>
       <h:form>
           <h:commandLink action="/consultant/List" value="Show All Consultant Items"/>
       </h:form>
       <h:form>
           <h:commandLink action="/consultantStatus/List" value="Show All ConsultantStatus Items"/>
       </h:form>
       <h:form>
           <h:commandLink action="/project/List" value="Show All Project Items"/>
       </h:form>
       <h:form>
           <h:commandLink action="/recruiter/List" value="Show All Recruiter Items"/>
       </h:form>
   </h:body>

2. Щелкните ссылку "Показать все элементы консультантов". При анализе приведенного выше кода можно отметить, что целевая страница – /consultant/List.xhtml. (В JSF 2.0 расширение файла является предполагаемым из-за неявного перехода.)
   
   Текущая база данных не содержит данные примера. Данные можно добавить вручную посредством нажатия ссылки "Create New Consultant" и использования предоставленной веб-формы. При этом инициируется отображение страницы /consultant/Create.xhtml. Для заполнения таблиц данными примера также можно выполнить сценарий SQL в среде IDE. В следующих подразделах рассматриваются оба эти варианта.

Для возврата к списку ссылок на странице приветствия щелкните индексную ссылку. По ссылкам открывается представление данных, хранящихся в каждой таблице базы данных, и инициируется файл List.xhtml для каждой отображаемой папки сущностей. Как будет показано ниже, после внесения данных в таблицу появятся другие ссылки для каждой записи, с помощью которых можно просматривать (View.xhtml), править (Edit.xhmtl) и удалять данные отдельной записи таблицы.

Заполнение базы данных с помощью сценария SQL

Запустите предоставленный сценарий, создающий данные примера для таблиц базы данных. Сценарий (mysql_insert_data_consult.sql) включен в файл ZIP "База данных консультационного агентства", который можно загрузить из таблицы требуемого программного обеспечения.

В зависимости от сервера базы данных, с которым вы работаете (MySQL или JavaDB), можно выполнить запуск предоставленного сценария, создающего данные примера для таблиц базы данных. Для MySQL таким сценарием является mysql_insert_data_consult.sql. Для JavaDB таким сценарием является javadb_insert_data_consult.sql. Оба сценария включены в соответствующие архивы, которые можно загрузить из таблицы требуемого программного обеспечения.

1. Выберите в основном меню "Файл" > "Открыть файл", затем перейдите к папке сценария на компьютере. Нажмите кнопку "Открыть". Файл автоматически открывается в редакторе SQL среды IDE.
2. Убедитесь, что база данных consult выбрана в раскрывающемся списке "Соединение" на панели инструментов редактора SQL.
   

   Либо щелкните правой кнопкой мыши в области редактора и выберите команду "Выполнить оператор", либо нажмите кнопку "Выполнить SQL" (). Результаты выполнения сценария отображаются в окне вывода.

3. Перезапустите сервер приложений GlassFish. Это необходимо для перезагрузки и кэширования новых данных при помощи сервера, содержащихся в базе данных consult. Чтобы этого добиться, нажмите на вкладку сервера GlassFish в окне вывода (вкладка сервера GlassFish показывает лог сервера), затем нажмите кнопку "Перезапустить сервер" () в левом поле. Сервер остановится, затем перезапустится.
4. Выполните проект еще раз и щелкните ссылку "Показать все элементы консультантов". Теперь можно заметить, что список больше не пуст.
   

   Поддержка баз данных NetBeans

   Можно использовать средство просмотра для таблиц базы данных в среде IDE, чтобы отображать и изменять данные таблиц, управляемые непосредственно в базе данных. Например, щелкните правой кнопкой мыши таблицу consultant в окне "Службы" и выберите команду "Просмотреть данные".

   

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

   

   Дважды щелкните ячейки таблицы для выполнения внутристрочных изменений данных. Щелкните значок "Фиксировать записи" () для фиксации изменений в базе данных.

   Графическое представление обеспечивает большую функциональность. Более подробную информацию можно получить из документа Поддержка баз данных в среде IDE NetBeans.

   
   

Изучение поддержки редактора на страницах Facelets

1. Откройте страницу /consultant/List.xhtml в редакторе. В строке 8 указывается, что визуализация страницы зависит от файла template.xhtml Facelets.

   <ui:composition template="/template.xhtml">

   Для отображения номеров строк щелкните правой кнопкой мыши в левом поле редактора и выберите команду "Показать номера строк".

2. С помощью диалогового окна "Переход к файлу" в среде IDE откройте файл template.xhtml. Нажмите сочетание клавиш ALT+SCHIFT+O (CTRL+SHIFT+O в Mac), затем введите template.
   

   Нажмите кнопку "ОК" (или нажмите клавишу ВВОД).

3. В шаблоне применяются теги <ui:insert> для вставки содержимого из других файлов в заголовок и тело. Установите курсор на тег <ui:insert>, затем нажмите сочетание клавиш CTRL+ПРОБЕЛ для вызова всплывающего окна документации.
   .

   Для вызова всплывающего окна документации можно нажать сочетание клавиш CTRL+ПРОБЕЛ, установив курсор на тегах JSF и соответствующих атрибутах. Отображаемая документация взята из описаний, предоставленных в официальной Документации о библиотеке тегов JSF.

4. Вернитесь к файлу List.xhtml (нажмите CTRL+TAB). Теги <ui:define> используются для определения содержимого, которое применяется в заголовке и теле шаблона. Этот шаблон используется для всех четырех файлов Facelets (Create.xhtml, Edit.xhtml, List.xhtml и View.xhtml), созданных для каждого класса сущностей.
5. Установите курсор на одном из выражений на языке выражений, используемых для локализованных сообщений, содержащихся в файле Bundle.properties. Для просмотра локализованного сообщения нажмите сочетание клавиш CTRL+ПРОБЕЛ.
   

   На приведенном выше изображении можно заметить, что выражение на языке выражений разрешено в списке "List", который применяется для заголовка шаблона и проверяется из отображаемой в обозревателе страницы.

6. Выполните прокрутку до конца файла и найдите код для ссылки Создать нового консультанта (строка 92). Это выглядит следующим образом:

   <h:commandLink action="#{consultantController.prepareCreate}" value="#{bundle.ListConsultantCreateLink}"/>

7. Для вызова всплывающего окна документации нажмите сочетание клавиш CTRL+ПРОБЕЛ на атрибуте action для commandLink.
   
   Атрибут action указывает на метод, обрабатывающий запрос при щелчке ссылки в обозревателе. Предоставлена следующая документация:
   
   
   Компонент MethodExpression определяет вызываемую операцию приложения при его активации пользователем. Выражение должно определять общедоступный метод, который не принимает параметры и возвращает объект (метод toString() которого вызывается для получения логического результата), передаваемый в NavigationHandler для этого приложения.
   
   Другими словами, значение action обычно относится к методу в управляемом компоненте JSF, который имеет значение String. Затем строка используется в NavigationHandler JSF для передачи запроса в соответствующее представление. Проверка этого осуществляется при выполнении следующих действий.
8. Установите курсор на consultantController и нажмите сочетание клавиш CTRL+ПРОБЕЛ. Функция автозавершения кода в редакторе указывает на то, что consultantController является управляемым компонентом JSF.
   
9. Переместите курсор на prepareCreate и нажмите сочетание клавиш CTRL+ПРОБЕЛ. При вызове функции автозавершения кода выводится список методов, содержащихся в управляемом компоненте ConsultantController.
   
10. Нажмите CTRL (&#8984 в Mac), затем наведите указатель мыши на prepareCreate. Будет создана ссылка, с помощью которой можно перейти непосредственно к методу prepareCreate() в управляемом компоненте ConsultantController.
    
11. Щелкните ссылку и просмотрите метод prepareCreate() (отображаемый ниже).

    public String prepareCreate() {
        current = new Consultant();
        selectedItemIndex = -1;
        return "Create";
    }

    Метод возвращает Create. Метод NavigationHandler собирает информацию в фоновом режиме и применяет строку Create в пути для открытия представления, отправленного в ответ на запрос: /consultant/Create.xhtml. (В JSF 2.0 расширение файла является предполагаемым из-за неявного перехода.)

Изучение целостности базы данных с проверкой поля

1. На странице "Список консультантов" в обозревателе щелкните ссылку "Create New Consultant". Как показано в предыдущем подразделе, это инициирует визуализацию страницы /consultant/Create.xhtml.
2. Введите в форму следующие подробные сведения. На данный момент оставьте оба поля RecruiterId и StatusId пустыми.
   
   

   Поле	Значение
   Id консультанта	2
   Эл. почта
   Пароль	jack.smart
   Почасовая ставка	75
   Оплачиваемая почасовая ставка	110
   Дата принятия на работу	22/07/2008
   Резюме	У меня большой опыт работы консультантом. Примите меня на эту должность, и вы не разочаруетесь!
   RecruiterId	---
   StatusId	---

3. Нажмите кнопку "Сохранить". При подобном заполнении поле StatusId будет отмечено ошибкой проверки.
   
   Почему это произошло? Повторно проверьте диаграмму "сущность/отношение" для базы данных консультационного агентства. Как указано выше в таблице связей, в таблицах CONSULTANT и CONSULTANT_STATUS совместно используется ненулевое отношение "один ко многим". Поэтому каждая запись в таблице CONSULTANT должна содержать ссылку на запись в таблице CONSULTANT_STATUS. Это отмечено во внешнем ключе consultant_fk_consultant_status, который имеет ссылки на две таблицы.

   Внешние ключи, хранящиеся в таблицах, можно просмотреть посредством развертывания узла "Внешние ключи" таблицы в окне "Службы" (CTRL+5; &#8984+5 на компьютере Mac).

   
4. Для устранения ошибки проверки выберите entity.ConsultantStatus[statusId=A] в раскрывающемся списке StatusId.
   
   Примечание. Поле RecruiterId можно оставить пустым. Как указано на диаграмме "сущность/отношение" для базы данных, между таблицами CONSULTANT и RECRUITER существует нулевое отношение "один ко многим", что означает, что создавать отношение между записями в таблице CONSULTANT с записью RECRUITER не требуется.
5. Нажмите кнопку "Сохранить". На экран выводится сообщение об успешном сохранении записи consultant. При щелчке ссылки Show All Consultant Items в таблице появится новая запись.

Как правило, на созданных страницах Facelets отображаются ошибки вводимой пользователем информации:

• пустые поля для ненулевых ячеек таблицы;
• изменения данных, которые нельзя изменять (например, первичные ключи);
• вставка данных неверного типа;
• изменения данных, когда представление пользователя больше не синхронизируется с базой данных.

Правка классов сущностей

В предыдущем подразделе был показан не совсем интуитивно понятный параметр entity.ConsultantStatus[statusId=A] в раскрывающемся списке StatusId. Необходимо учитывать, что текст, отображаемый для каждой позиции в этом раскрывающемся списке, является строковым представлением каждой обнаруженной сущности ConsultantStatus (т.е., вызывается метод toString() класса сущностей).

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

1. Откройте в редакторе файл /consultant/Create.xhtml. Это форма "Создание нового консультанта", отображаемая в обозревателе. Выполните прокрутку вниз до кода раскрывающегося списка StatusId (выделено ниже жирным шрифтом).

       <h:outputLabel value="#{bundle.CreateConsultantLabel_resume}" for="resume" />
       <h:inputTextarea rows="4" cols="30" id="resume" value="#{consultantController.selected.resume}" title="#{bundle.CreateConsultantTitle_resume}" />
       <h:outputLabel value="#{bundle.CreateConsultantLabel_statusId}" for="statusId" />
       <h:selectOneMenu id="statusId" value="#{consultantController.selected.statusId}" title="#{bundle.CreateConsultantTitle_statusId}" required="true" requiredMessage="#{bundle.CreateConsultantRequiredMessage_statusId}">
           <f:selectItems value="#{consultantStatusController.itemsAvailableSelectOne}"/>
       </h:selectOneMenu>
       <h:outputLabel value="#{bundle.CreateConsultantLabel_recruiterId}" for="recruiterId" />
       <h:selectOneMenu id="recruiterId" value="#{consultantController.selected.recruiterId}" title="#{bundle.CreateConsultantTitle_recruiterId}" >
           <f:selectItems value="#{recruiterController.itemsAvailableSelectOne}"/>
       </h:selectOneMenu>
   </h:panelGrid>

2. Проверьте атрибут value, применяемый к тегу <f:selectItems>. Атрибут value определяет текст, отображаемый для каждой позиции в раскрывающемся списке.
   
   Нажмите сочетание клавиш CTRL+ПРОБЕЛ, установив курсор на itemsAvailableSelectOne. Автозавершение кода в редакторе указывает, что метод getItemsAvailableSelectOne() для ConsultantStatusController возвращает массив объектов SelectItem.
   
3. Нажмите CTRL (&#8984 в Mac), затем наведите указатель мыши на itemsAvailableSelectOne. Создается ссылка, позволяющая переходить непосредственно к методу getItemsAvailableSelectOne() в исходном коде сущностей ConsultantStatus. Щелкните эту ссылку.
4. Установите курсор на значении возврата SelectItem[] в сигнатуре метода и нажмите сочетание клавиш CTRL+ПРОБЕЛ для вызова всплывающего окна документации.
   

   Щелкните значок веб-обозревателя () в окне документации для открытия документации Javadoc во внешнем веб-обозревателе.

   Итак, класс SelectItem относится к инфраструктуре JSF. Компонент UISelectOne, как упоминалось в документации, представлен тегом <h:selectOneMenu> из разметки, проверенной выше в Шаге 1.
5. Нажмите CTRL (&#8984 в Mac), затем наведите указатель мыши на findAll(). Появится всплывающее окно, отображающее сигнатуру метода.
   
   Здесь можно отметить, что ejbFacade.findAll() возвращает List объектов ConsultantStatus.
6. Перейдите к JsfUtil.getSelectItems. Наведите указатель мыши на getSelectItems и нажмите CTRL (&#8984 на компьютере Mac), затем щелкните появившуюся ссылку.
   
   Примечание. Следует помнить, что JsfUtil является одним из служебных классов, созданных при завершении работы мастера создания страниц JSF из классов сущностей.
   
   Этот метод организует цикл по списку сущностей (т.е., по списку List объектов ConsultantStatus) и создает SelectItem для каждой позиции. Как показано ниже (выделено жирным шрифтом), каждая позиция SelectItem создана с помощью объекта сущностей и метки объекта.

   public static SelectItem[] getSelectItems(List<?> entities, boolean selectOne) {
       int size = selectOne ? entities.size() + 1 : entities.size();
       SelectItem[] items = new SelectItem[size];
       int i = 0;
       if (selectOne) {
           items[0] = new SelectItem("", "---");
           i++;
       }
       for (Object x : entities) {
           items[i++] = new SelectItem(x, x.toString());
       }
       return items;
   }

   Эта метка создана с помощью метода toString() сущностей и является представлением объекта, отображаемым в этом ответе. (См. определение документации Javadoc для конструктора SelectItem(значение java.lang.Object, метка java.lang.String).)
   
   После проверки того, что методом toString() сущности является метод, отображаемый в обозревателе при просмотре позиций в раскрывающемся списке, измените метод ConsultantStatus toString().
7. Откройте класс сущностей ConsultantStatus в редакторе. Измените метод toString для возврата statusId и description. Это свойства записей, соответствующие двум столбцам таблицы CONSULTANT_STATUS.

   public String toString() {
       return statusId + ", " + description;
   }

8. Выполните проект еще раз. При отображении в обозревателе страницы приветствия щелкните ссылку Show All Consultant Items, затем нажмите Create New Consultant.
   
   Просмотрите раскрывающийся список StatusId. Теперь на экран будет выведен идентификатор состояния и описание записи, содержащейся в таблице CONSULTANT_STATUS базы данных.
   

Статьи и учебные курсы по NetBeans

• Введение в JavaServer Faces 2.0 в среде IDE NetBeans
• Поддержка JSF 2.0 в среде IDE NetBeans
• Scrum Toys — полный пример приложения JSF 2.0
• Начало работы с приложениями для Java EE
• Учебная карта по Java EE и Java Web

Внешние ресурсы

• Технология JavaServer Faces (официальная домашняя страница)
• Спецификация JSR 314 для JavaServer Faces 2.0
• Руководство по Java EE 6. Глава 5. Технология JavaServer Faces
• GlassFish Project Mojarra (официальный пример реализации JSF 2.0)
• OTN Discussion Forums : JavaServer Faces(форумы обсуждения OTN: JavaServer Faces)
• JSF Central

Блоги

• Эд Бернс (Ed Burns)
• Райан Лубке (Ryan Lubke)
• Джим Дрисколл (Jim Driscoll)