Использование веб-служб StrikeIron в веб-приложениях

В этом руководстве описываются действия по организации использования веб-служб StrikeIron, входящими в состав среды IDE NetBeans 6.1 или 6.0, с помощью Visual Web Designer. В частности, в нем продемонстрировано, как создать веб-приложение, вызывающее службу "US Address Verification" для проверки адреса, введенного пользователем.

Содержание

• Создание веб-проекта
• Разработка веб-страницы
• Реализация веб-страницы
• Тестирование веб-страницы
• Поиск дополнительных служб StrikeIron

Для работы с этим руководством требуется программное обеспечение и ресурсы, перечисленные ниже.

Программное обеспечение или ресурс	Требуемая версия
Среда IDE NetBeans	Web & Java EE, версия 6.1 или 6.0
Комплект для разработчика на языке Java (JDK)	версия 6 или версия 5
Веб-сервер или сервер приложений, совместимый с Java EE	Веб-сервер Tomcat 6.0 и/или Сервер приложений GlassFish v2

При необходимости серверы Tomcat и GlassFish могут быть установлены при помощи дистрибутива "Web and Java EE" среды IDE NetBeans. Также можно воспользоваться страницей загрузок GlassFish или страницей загрузок Apache Tomcat.

Для доступа к веб-службам StrikeIron необходима учетная запись StrikeIron. Пользователи NetBeans при регистрации новой учетной записи StrikeIron получают право бесплатного обращения к StrikeIron. Для получения дополнительных сведений посетите веб-сайт http://developer.strikeiron.com/netbeans/freetrial/.

Среда IDE NetBeans 6.0 и 6.1 поставляется с рядом популярных веб-служб StrikeIron. Для получения доступа к ним необходимо переключиться на окно "Services", развернуть узел "Web Services" и открыть узел "StrikeIron Services". Через некоторое время после загрузки должны появиться следующие службы (в 6.0–6.1 имеется множество других служб):

Далее в руководстве будет показано, как можно организовать использование этих веб-служб путем их перетаскивания в Visual Web Designer.

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

Сначала необходимо создать веб-проект, поддерживаемый Visual Web Designer.

1. Выберите "File > New Project". В области "Categories" выберите "Web". В области "Projects" выберите "Web Application" и нажмите кнопку "Next".
2. В поле "Project Name" введите USAddressVerificationDemo.
3. В области "Server" выберите сервер и нажмите кнопку "Next".
4. На экране "Frameworks" выберите инфраструктуру визуальных веб-приложений JavaServer Faces, как показано ниже:
   
5. Нажмите кнопку "Finish".

Разработка веб-страницы

После создания проекта USAddressVerificationDemo среда IDE автоматически открывает во вкладке "Design" страницу Page1.jsp по умолчанию с пустым холстом. На правой стороне холста находится окно "Palette" (доступное в меню "Window"). Страница будет реализована, как показано ниже:

Ниже приведена процедура разработки этой страницы:

1. Перетащите элемент "Label" с палитры на холст. После создания метки на холсте можно изменить текст метки. Повторите это действие и создайте в общей сложности 4 метки. Для обеспечения требуемого размещения можно перемещать метки с помощью мыши.
2. Подтащите элемент "Text Field" к каждому элементу "Label". Создайте в общей сложности 4 текстовых поля.
3. Измените свойство идентификатора каждого текстового поля путем выбора текстового поля с помощью мыши и изменения идентификатора в окне "Properties" текстового поля. Установите свойства id текстовых полей в следующие значения: addressLine1TF, addressLine2TF, cityStateZipTF и resultTF.
4. Щелкните правой кнопкой мыши все 4 текстовых поля и выберите "Add Binding Attribute" в контекстном меню каждого из них.
5. Перетащите элемент "Button" в требуемое местоположение и измените текст на "Validate", а id – на validateButton.
6. Перейдите в окно "Services". В окне "Services" разверните узел "Web Services", затем узел "StrikeIron Services", потом узел "USAddressVerification" и, наконец, узел "USAddressVerificationSoap".
7. Перетащите узел операции verifyAddressUSA на холст. Как показано на приведенном выше рисунке, под узлом Page1 в окне "Navigator" должны появиться два новых узла, USAddressVerificationSOAPVerifyAddressUSA1 и USAddressVerificationSoapClient1.

Реализация веб-страницы

В этом разделе приведен код для вызова службы "US Address Verification". Этот код для сбора данных и отображения результата использует веб-страницу, созданную в упражнении Разработка веб-страницы.

1. На холсте Page1.jsp дважды щелкните кнопку "Validate". После перехода среды IDE в режим просмотра исходного кода Java курсор будет установлен на "validateButton_action()".
2. Введите или вставьте следующий код. Замените значения параметров для bean.setUserID и bean.setPassword соответствующими учетными данными StrikeIron.

   public String validateButton_action() {
       USAddressVerificationSoapVerifyAddressUSA bean =
               this.getUSAddressVerificationSoapVerifyAddressUSA1();
       //bean.setUnregisteredUserEmail("your_email_address_here");
       bean.setUserID("your_strikeiron_userid_here");
       bean.setPassword("your_strikeiron_password_here");
       bean.setAddressLine1((String) getAddressLine1TF().getText());
       bean.setAddressLine2((String) getAddressLine2TF().getText());
       bean.setCityStateZip((String) getCityStateZipTF().getText());
   
       getResultTF().setText(bean.invokeMethod().getAddressStatus());
   
       return null;
   }

   Примечание: Для получения доступа к веб-службам StrikeIron необходимы идентификатор пользователя и пароль StrikeIron. При регистрации учетной записи StrikeIron предоставляется возможность бесплатного посещения StrikeIron. Для получения дополнительных сведений посетите веб-сайт http://developer.strikeiron.com/netbeans/freetrial/.

Тестирование веб-страницы

Для тестирования приложения необходимо выполнить следующие действия:

1. В окне "Projects" щелкните правой кнопкой мыши проект и выберите "Run". Запустится сервер, и откроется обозреватель.
2. В обозревателе введите адрес в текстовых полях "Address Line 1", "Address Line 2" и "City State & Zip" и нажмите кнопку "Validate". В поле "Result" должен появиться показанный ниже результат:
   

Поиск дополнительных служб StrikeIron

В окне "Services" щелкните правой кнопкой мыши узел "StrikeIron Services" и выберите "Find StrikeIron Services". Введите строку поиска, например, "stock", и нажмите клавишу Enter. Когда поиск завершится, его результаты отобразятся в виде списка слева от диалогового окна. Выделите строку для просмотра подробного описания службы.



Для использования службы выделите ее и нажмите кнопку "Add". Новая служба добавляется в папку StrikeIron и сразу после этого может быть протестирована.



Мы ждем ваших отзывов



Дополнительная информация

Для получения дополнительных сведений о разработке приложений для Java EE в среде IDE NetBeans см. следующие материалы:

• Разработка клиентов веб-служб JAX-WS
• Начало работы с веб-службами JAX-WS
• Начало работы с веб-службами RESTful на сервере GlassFish
• Передача двоичных данных с помощью приложения веб-службы
• Расширенные возможности взаимодействия веб-служб
• Учебная карта по приложениям на базе EJB и веб-службам

Оставить комментарии и предложения, обратиться за поддержкой и получить информацию о последних достижениях в области функциональных возможностей разработки для Java EE с помощью среды IDE NetBeans можно в списке рассылки .