Содержание   -  Создание проекта -  Добавление возможности вставки записей -  Изменение страницы для сохранения записей -  Добавление возможности удаления записей -  Добавление возможности отмены изменений

Создание проекта

1. На странице Welcome выберите Create New Project.
   
   
2. Выберите Web на панели Categories, JSF Web Application на панели Projects и нажмите на кнопку Next. Ваше веб-приложение будет построено при помощи технологии JavaServer Faces (JSF).
   
   
3. Назовите проект характерным именем, например, InsertUpdateDelete. Нажмите на кнопку Finish.

1. Откройте закладку с компонентами (Components) в окне палитры (Palette) и раскройте секцию Basic, чтобы увидеть компоненты, которые вы будете использовать на странице.
   
   
2. Перетащите мышкой следующие компоненты на дизайнер страницы:
   
   
   • выпадающий список (Drop Down List). Поместите его в левый верхний угол страницы.
     
     
   • окно системных сообщений (Message Group). Поместите его справа от выпадающего списка. Окно системных сообщений отображает ошибки проверки корректности и преобразования данных, а также сообщения, переданные в Java Server Faces контекст методами info() и error(). Эти сообщения могут быть полезны при отладке проекта.
     
     
   • таблицу (Table). Поместите ее под двумя предыдущими компонентами.
     
     
   Сейчас ваша страница должна выглядеть так, как на рисунке 1.
   
   

   Figure 1 : Initial Page Layout

1. Выберите выпадающий список в дизайнере и в окне свойств (Properties) измените свойство General > id на personDD.
   
   
2. Щелкните правой кнопкой мыши на выпадающем списке personDD в дизайнере и выберите Bind to Data во всплывающем меню. Появится диалоговое окно Bind to Data.
   
   
3. В диалоговом окне Bind to Data перейдите на закладку Bind to Data Provider и выберите Add Data Provider. Появится диалоговое окно Add Data Provider.
   
   
4. В диалоговом окне Add Data Provider раскройте узел Data Sources > Travel > Tables и выберите таблицу PERSON. Нажмите на кнопку Add.
   
   

   Figure 2 : Add Data Provider Dialog Box

    
   
5. В диалоговом окне Bind to Data нажмите на кнопку OK. Будет создана переменная personDataProvider, привязанная к выпадающему списку personDD.
   
   

   Figure 3 : Bind to Data Dialog Box

    
   
6. Щелкните правой кнопкой мыши на выпадающем списке и выберите Auto-Submit во всплывающем меню. При этой установке страница будет отсылаться на сервер всякий раз, когда в выпадающем списке будет выбрано новое значение.
   
   
7. Щелкните правой кнопкой мыши на выпадающем списке и выберите Configure Virtual Forms во всплывающем меню. Обратите внимание, что в левом верхнем углу появившегося диалогового окна  написано personDD, что указывает, что выбран соответствующий выпадающий список. Более подробную информацию об использовании виртуальных форм можно найти в учебном пособии Using Virtual Forms.
   
   
8. Нажмите на кнопку New. Введите  person в столбце Name, выберите Yes в столбцах Participate и Submit.
   
   

   Figure 4: Configuring Virtual Forms

    
   При помощи виртуальных форм приложение может избегать ненужных проверок корректности данных.
   
   
9. Нажмите на кнопку OK.
   
   
10. Нажмите на кнопку Show Virtual Forms на панели инструментов дизайнера . Просмотр виртуальных форм позволяет увидеть взаимосвязь между компонентами в дизайнере и любыми созданными вами виртуальными формами.
    
    

    Figure 5 : Showing Virtual Forms

1. Щелкните правой кнопкой мыши на таблице и выберите Bind to Data во всплывающем меню.
   
   
2. Нажмите на кнопку Add Data Provider. Появится диалоговое окно Add Data Provider.
   
   
3. В диалоговом окне Add Data Provider раскройте узел Data Sources > Travel > Tables и выберите таблицу TRIP. Нажмите на кнопку Add. Будет создан провайдер данных tripDataProvider и появится диалоговое окно.
   
   
4. Диалоговое окно показывает поля, доступные в только что созданном tripDataProvider и позволяет задавать набор полей, которые будут отображаться в таблице. Удалите при помощи кнопки < поля TRIP.TRIPID и TRIP.PERSONID из списка Selected справа, как показано на рисунке. Значения этих полей важны только для программистов и не должны показываться пользователям.
   
   

   Figure 6 : Binding Table to Data Provider

    
   
5. Нажмите на кнопку OK, чтобы сохранить изменения и закрыть диалоговое окно.
   
   
6. Снова выберите таблицу в дизайнере, щелкните на ней правой кнопкой мыши и выберите Table Layout во всплывающем меню.
   
   
7. Перейдите на закладку Options и измените заголовок (Title) на Trips Summary. Нажмите на кнопку OK.
   
   СОВЕТ: Вы также можете изменить заголовок таблицы, выбрав и отредактировав его прямо в дизайнере.
   
   Теперь ваша таблица должна выглядеть в дизайнере так, как показано на рисунке 7. Обратите внимание, что если столбцы идут не в требуемом порядке, вы можете переставить их, снова открыв диалоговое окно Table Layout, перейдя на закладку Columns и используя кнопки Up и Down.
   
   

   Figure 7 : Page1 Table Layout

    
   
8. В окне Outline раскройте узел SessionBean1, щелкните правой кнопкой мыши на  tripRowSet и выберите Edit SQL Statement во всплывающем меню. Откроется редактор SQL-запросов.
   
   
9. Щелкните правой кнопкой мыши в таблице, расположенной примерно в центре окна, на строке PERSONID и выберите Add Query Criteria. Откроется диалоговое окно Add Query Criteria.
   
   
10. В этом окне выберите переключатель Parameter и нажмите на кнопку OK. Символы "=?" появятся в ячейке таблицы PERSONID-Criteria, а в конце SQL-запроса в панели SQL добавится условие "WHERE TRAVEL.TRIP.PERSONID=?".
    
    СОВЕТ: Для быстроты вы можете не вызывать диалоговое окно Add Query Criteria, а вместо этого выбрать ячейку PERSONID-Criteria и набрать там  "=?", после чего нажать Tab для сохранения изменений.
    
    
11. Закройте редактор SQL-запросов.

1. Щелкните правой кнопкой мыши на таблице и выберите Table Layout во всплывающем меню. Откроется диалоговое окно Table Layout.
   
   
2. Перейдите на закладку Columns и выберите TRIP.DEPDATE в списке Selected справа. В настройках свойств, расположенных в нижней части диалогового окна, сделайте следующие изменения:
   
   
   • Измените значение текстового поля Header с DEPDATE на Date.
   • При помощи выпадающего списка Component Type измените тип компонента со Static Text на Text Field.
     
     
3. Выберите поле TRIP.DEPCITY в списке Selected и сделайте следующие изменения:
   
   
   • Измените значение текстового поля Header с DEPCITY на From City.
   • При помощи выпадающего списка Component Type измените тип компонента со Static Text на Text Field.
     
     
4. Выберите поле TRIP.DESTCITY в списке Selected и сделайте следующие изменения:
   
   
   • Измените значение текстового поля Header с DESTCITY на To City.
   • При помощи выпадающего списка Component Type измените тип компонента со Static Text на Text Field.
     
     
5. Выберите поле TRIP.TRIPTYPEID в списке Selected и сделайте следующие изменения:
   
   
   • Измените значение текстового поля Headerс TRIPTYPEID на Trip Type.
   • При помощи выпадающего списка Component Type измените тип компонента со Static Text на Drop Down List.
     
     
6. Нажмите на кнопку OK для сохранения изменений и закрытия диалогового окна. Если после проделанных действий столбцы таблицы оказались слишком широкими, вы можете изменить их размер, выбрав первый компонент колонки и перетащив ее границы на нужное расстояние.
   
   
7. В дизайнере выберите верхний компонент с выпадающим списком в таблице. Щелкните на нем правой кнопкой мыши и выберите Bind to Data во всплывающем меню. Откроется диалоговое окно Bind to Data.
   
   
8. В диалоговом окне Bind to Data перейдите на закладку Bind to Data Provider и нажмите на кнопку Add Data Provider. Откроется диалоговое окно Add Data Provider.
   
   
9. В диалоговом окне Add Data Provider раскройте узел Data Sources > Travel > Tables и выберите TRIPTYPE. Нажмите на кнопку Add. В результате будет создан провайдер данных triptypeDataProvider и вновь появится диалоговое окно Bind to Data.
   
   
10. В диалоговом окне Bind to Data выберите triptypeDataProvider из выпадающего списка.
    
    
11. В списке Value field выберите TRIPTYPE.TRIPTYPEID; в списке Display field выберите TRIPTYPE.NAME, как показано на рисунке 8. Нажмите на кнопку OK для сохранения изменений и закрытия диалогового окна.
    
    

    Figure 8 : Bind to Data Dialog Box

     

1. В дизайнере выделите при помощи комбинации Ctrl-Click три текстовых поля и выпадающий список в таблице. Щелкните правой кнопкой мыши на любом из выбранных компонентов и выберите Configure Virtual Forms во всплывающем меню.
   
   
2. Убедитесь, что три текстовых поля и выпадающий список перечислены в левом вехнем углу появившегося диалогового окна Configure Virtual Forms. Если они не перечислены так, как показано на рисунке 9, закройте диалоговое окно, заново выделите  их и попробуйте снова. Если они перечислены как надо, нажмите на кнопку New.
   
   
3. Измените имя новой виртуальной формы на save. Установите параметр Participate в Yes, как показано на рисунке 9, и нажмите на кнопку OK, чтобы закрыть окно.
   
   

   Figure 9 : Configuring Virtual Forms for Table Elements

    
   

1. Выполните двойной щелчок мышью на выпадающем списке personDD для создания метода, обрабатывающего событие valueСhange, и открытия редактора Java-кода на этом методе.
   
   
2. Обратите внимание на комментарий в этом методе // TODO: Replace with your code. Введите вместо этого комментария свой код так, чтобы обработчик события выглядел так же, как в примере 1.
   
   

   Code Sample 1: Drop Down List Event Handler

   public void personDD_processValueChange(ValueChangeEvent vce) { Object selectedPersonId = personDD.getSelected(); try { personDataProvider.setCursorRow( personDataProvider.findFirst("PERSON.PERSONID", selectedPersonId)); getSessionBean1().getTripRowSet().setObject(1, selectedPersonId); tripDataProvider.refresh(); form1.discardSubmittedValues("save"); } catch (Exception e) { error("Cannot switch to person " + selectedPersonId); log("Cannot switch to person " + selectedPersonId, e); } }

    
   В конце блока try оператор form1.discardSubmittedValues("save"); гарантирует, что всякий раз, когда пользователь выбирает нового человека в выпадающем списке, текущее содержимое таблицы будет заменено на новую информацию, относящуюся к выбранному человеку. Напомним, что все элементы интерфейса, отображающие информацию о поездке, участвуют в виртуальной форме save.
   
   Обратите внимание, что обработчик событий не генерирует исключений. Вместо этого он записывает их в серверный лог (файл server.log). Он также вызывает метод error, и, соответственно, в случае ошибки в обработчике событий будет отображено сообщение в компоненте Message Group, который мы поместили на страницу.
   
   
3. Переместитесь в Java-коде на метод prerender() (или, если вам так удобнее, нажмите Ctrl-F и найдите текст prerender при помощи диалогового окна Find). Сделайте метод таким, как показано в примере 2.
   
   

   Code Sample 2: Prerender Method

   public void prerender() { if ( personDD.getSelected() == null ) { Object firstPersonId = null; try { personDataProvider.cursorFirst(); firstPersonId = personDataProvider.getValue("PERSON.PERSONID"); personDD.setSelected(firstPersonId); getSessionBean1().getTripRowSet().setObject( 1, firstPersonId); tripDataProvider.refresh(); } catch (Exception e) { error("Cannot switch to person " + firstPersonId); log("Cannot switch to person " + firstPersonId, e); } } }

    
   
4. Щелкните правой кнопкой мыши в редакторе Java-кода и выберите Reformat Code, чтобы код был правильно отформатирован.

Figure 10: Deployed Application, Test 1

Добавление возможности вставки записей

1. Откройте страницу Page1 в дизайнере.
   
   
2. Перетащите компонент Message из секции Basic палитры на самое верхнее текстовое поле каждого из трех первых столбцов таблицы.
   
   
3. Нажав и удерживая Ctrl-Shift, щелкните мышью и перетащите курсор с каждого компонента Message на соответствующее текстовое поле. При этом курсор мыши меняется на символ связи, как это показано для столбца From City на рисунке 11. Когда компонент Message правильно ассоцирован с текстовым полем, текст Message отображает эту ассоциацию, как это показано для столбца Date column на рисунке 11.
   
   

   Figure 11: Associating Message Components with Text Fields

    
   

1. Перетащите компонент Button из секции Basic палитры на страницу Page1 и поместите его над таблицей рядом со второй колонкой, как показано на рисунке 12.
   
   
2. Текст кнопки сейчас выбран в дизайнере. Измените этот текст с Button на Add Trip. Нажмите Enter или щелкните  мышью вне кнопки для сохранения изменений.
   
   
3. Выберите кнопку и в окне Properties измените свойство General > (id) на add.
   
   
4. Выполните двойной щелчок мышью на кнопке. Откроется редактор Java-кода на обработчике событий этой кнопки.
   
   
5. Измените код обработчика событий (метод add_action()) так, как в примере 3:
   
   

   Code Sample 3: Add Trip Action Code

   public String add_action() { try { RowKey rk = tripDataProvider.appendRow(); tripDataProvider.setCursorRow(rk); tripDataProvider.setValue("TRIP.TRIPID", new Integer(0)); tripDataProvider.setValue("TRIP.PERSONID", personDD.getSelected()); tripDataProvider.setValue("TRIP.TRIPTYPEID", new Integer(1)); } catch (Exception ex) { log("Error Description", ex); error(ex.getMessage()); } return null; }

    
   
6. Если редактор Java-кода выведет ошибку о том, что IDE не может найти класс RowKey (или другой класс), вы можете это исправить, применив функцию редактора Java-кода Fix Imports. Она автоматически добавляет необходимые операторы import  в текущий класс ( в данном случае - Page1.java). Для вызова этой функции щелкните правой кнопкой мыши в редакторе Java-кода и выберите Fix Imports во всплывающем меню. Для ссылки на класс RowKey функция Fix Imports добавит следующий оператор в блок import:
   
   import com.sun.data.provider.RowKey;

Figure 12 : Deployed Application, Test 2

Изменение страницы для сохранения записей

1. Нажмите на кнопку Design окна редактирования для возвращения в дизайнер страницы Page1.
   
   
2. В окне Servers выберите таблицу Data Sources > Travel > Tables > TRIP table и перетащите ее на узел SessionBean1 в окне Outline.
   
   

   Figure 13 : Dragging TRIP Table onto SessionBean1

    
   Откроется диалоговое окно Add New Data Provider.
   
   
3. Выберите вариант Create SessionBean1/tripRowSet1, измените имя провайдера данных на maxTripRowSet и нажмите на кнопку OK.
   
   

   Figure 14 : Adding New Data Provider to SessionBean1

    
   В результате в SessionBean1 будут созданы maxTripDataProvider and maxTripRowSet.
   
   
4. В окне Outline выполните двойной щелчок мышью на SessionBean1 > maxTripRowSet для открытия редактора SQL-запросов. Щелкните на панели SQL (третья сверху). Удалите имеющийся SQL-запрос и введите следующий запрос:
   
   SELECT max(TRAVEL.TRIP.TRIPID)+1 as MAXTRIPID FROM TRAVEL.TRIP
   
   Значение MAXTRIPID будет использоваться в обработчике нажатия на кнопку Save, которую мы сейчас добавим.
   
   
5. Закройте редактор SQL-запросов. Обратите внимание, что запрос такого типа не поддерживается  графическим интерфейсом  редактора SQL-запросов. При появлении диалогового окна с предупреждением о возможной лексической ошибке вы можете спокойно закрыть его, выбрав Continue.

1. Добавьте кнопку на страницу сверху от первой колонки таблицы.
   
   
2. Измените текст на кнопке с Button на Save Changes.
   
   
3. В окне Properties поменяйте значение свойства General > (id) на save.
   
   
4. Нажмите правой кнопкой мыши на кнопку Save Changes и выберите Configure Virtual Forms во всплывающем меню. Откроется диалоговое окно Configure Virtual Forms.
   
   
5. Убедитесь, что в появившемся окне Configure Virtual Forms идентификатор save указан в списке в левом  верхнем углу, так что сделанные вами в этом окне изменения будут относиться к кнопке Save Changes. Затем выберите виртуальную форму save, измените значение Submit на Yes и нажмите на кнопку OK.
   
   
6. В дизайнере выполните двойной щелчок мышью на кнопке Save Changes. Откроется редактор Java-кода на обработчике событий этой кнопки.
   
   
7. Замените код обработчика событий (метод save_action() ) на указанный в примере 4.
   
   ПРИМЕЧАНИЕ: Этот код написан для Java Studio Creator 2 Update 1. Если вы используете  Java Studio Creator 2, измените

   int newTripId = ((Integer) maxTrip.getValue("MAXTRIPID")).intValue();

   на

   int newTripId = ((Long) maxTrip.getValue("MAXTRIPID")).intValue();

   
   

   Code Sample 4: Save Action Code

   public String save_action() { try { // Get the next key, using result of query on MaxTrip data provider CachedRowSetDataProvider maxTrip = getSessionBean1().getMaxTripDataProvider(); maxTrip.refresh(); maxTrip.cursorFirst(); int newTripId = ((Integer) maxTrip.getValue("MAXTRIPID")).intValue(); // Navigate through rows with data provider if (tripDataProvider.getRowCount() > 0) { tripDataProvider.cursorFirst(); do { if (tripDataProvider.getValue("TRIP.TRIPID").equals (new Integer(0))) { tripDataProvider.setValue("TRIP.TRIPID", new Integer(newTripId)); newTripId++; } } while (tripDataProvider.cursorNext()); }; tripDataProvider.commitChanges(); } catch (Exception ex) { log("Error Description", ex); error("Error :"+ex.getMessage()); } return null; }

    
   

• Вы можете добавить и сохранить поездку. После этого поездка появляется в таблице и не исчезает, если вы выбираете другого человека, а затем возвращаетесь к предыдущему .
  
  
• Вы можете отредактировать информацию об имеющейся поездке и сохранить изменения.
  
  
• Если вы ввели в поле Date что-то, не являющееся датой, приложение выдаст сообщение об ошибке.
  
  
• Вы можете нажать на кнопку Add Trip несколько раз, прежде чем сохранять изменения, это простой способ добавления большого количества строк за один раз.
  
  
• Если вы выберете другого человека, не сохранив изменения, все ваши изменения (в том числе заполненные новые строки) будут потеряны.
  
  
• Если вы измените некоторые значения и затем щелкните по одному из заголовков столбцов (для сортировки по этому столбцу), таблица запомнит сделанные изменения, и они затем могут быть сохранены.

Добавление возможности удаления записей

1. В дизайнере щелкните п&#