Выбор контейнера

Веб-служба может быть развернута в веб-контейнере или в контейнере EJB. Это зависит от конкретной реализации. Например, если развертывание планируется на веб-сервере Tomcat, предоставляющем только веб-контейнер, следует создавать веб-приложение, а не модуль EJB.

1. Выберите "File > New Project" (Ctrl-Shift-N). Выберите "Web Application" в категории "Web" или "EJB Module" в категории "Enterprise".
2. Присвойте проекту имя CalculatorWSApplication.
3. В зависимости от используемого сервера развертывания, выполните следующее:
   • При использовании GlassFish выберите "Java EE 5" в поле "Java EE Version".
   • При использовании веб-сервера Tomcat удалите флажок "Set Source Level to 1.4".
4. Перейдите по остальным страницам и нажмите кнопку "Finish".

Создание веб-службы из класса Java

1. Щелкните правой кнопкой мыши узел CalculatorWSApplication и выберите "New > Web Service".
2. Присвойте веб-службе имя CalculatorWS, введите org.me.calculator в поле "Package" и нажмите кнопку "Finish".

   В окне "Projects" отображается структура новой веб-службы, а в области изменения отображается Visual Designer. Например, для веб-приложений экран должен выглядеть следующим образом:

   
   

Добавление бизнес-логики к веб-службе

1. Нажмите кнопку "Add Operation" в Visual Designer. Появится диалоговое окно, в котором можно определить новую операцию.
2. В верхней части диалогового окна "Add Operation" введите add в поле "Name" и int в раскрывающемся списке "Return Type". В нижней части диалогового окна "Add Operation" нажмите кнопку "Add" и создайте параметр типа int с именем i. Далее нажмите кнопку "Add" еще раз и создайте параметр типа int с именем j.

   Экран должен выглядеть следующим образом:

   
   
3. Нажмите кнопку "OK" в нижней части диалогового окна "Add Operation".

   Теперь в Visual Designer отображается следующее:

   
   
4. Нажмите кнопку "Source" и обратите внимание, что созданный выше исходный код теперь выглядит следующим образом:
   
5. В редакторе расширьте скелетную операцию add следующим образом (изменения выделены полужирным шрифтом):

       @WebMethod
       public int add(@WebParam(name = "i") int i, @WebParam(name = "j") int j) {
           int k = i + j;
           return k;
               }

Как видно из кода, веб-служба просто получает два числа и затем возвращает их сумму. В следующем разделе рассматривается тестирование веб-службы в среде IDE.

Клиент 1: класс Java в приложении для Java SE

В этом разделе будет рассмотрено создание стандартного приложения на Java. Мастер, используемый для создания приложения, создает также класс Java. Затем веб-служба, созданная в начале этого руководства, будет использоваться при помощи средств среды IDE.

1. Выберите "File > New Project" (Ctrl-Shift-N). Выберите "Java Application" в категории "Java". Присвойте проекту имя CalculatorWS_Client_Application. Не снимайте флажок "Create Main Class" и оставьте все прочие значения по умолчанию. Нажмите кнопку "Finish".
2. При использовании IDE NetBeans 6.0.x следует изменить свойства проекта CalculatorWS_Client_Application. Щелкните правой кнопкой мыши узел проекта и выберите "Properties". Откроется диалоговое окно "Project Properties". Следующее действие зависит от используемого JDK:
   • С более ранним JDK, чем JDK 6 Update 4, следует выбрать категорию "Libraries" и импортировать библиотеки JAX-WS и JAXB.
   • С JDK 6 Update 4 или выше следует выбрать категорию "Run" и удалить "VM Option".
3. Щелкните правой кнопкой мыши узел CalculatorWS_Client_Application и выберите "New > Web Service Client".
4. В окне "Project" нажмите кнопку "Browse". Перейдите к веб-службе, которую необходимо использовать. Выберите веб-службу и нажмите кнопку "OK".
5. Оставьте остальные параметры настройки по умолчанию (в 6.0.x не указывайте имя пакета) и нажмите кнопку "Finish".

   В окне "Projects" появится новый клиент веб-службы с узлом для созданного метода add:

   
   
6. Дважды щелкните элемент Main.java для его открытия в редакторе исходного кода. Удалите комментарий TODO и перетащите узел add выше в пустую строку. Экран должен выглядеть следующим образом:

   public static void main(String[] args) {
   
       try { // Call Web Service Operation
           org.me.calculator.CalculatorWSService service = new org.me.calculator.client.CalculatorWSService();
           org.me.calculator.CalculatorWS port = service.getCalculatorWSPort();
           // TODO initialize WS operation arguments here
           int i = 0;
           int j = 0;
           // TODO process result here
           int result = port.add(i, j);
           System.out.println("Result = "+result);
       } catch (Exception ex) {
           // TODO handle custom exceptions here
       }
   
                   }

   Примечание: Вместо перемещения узла add можно щелкнуть правой кнопкой мыши в редакторе и затем выбрать "Web Service Client Resources > Call Web Service Operation".

7. Задайте два значимых целых числа (например, 3 и 4). Это могут быть значения любых целых чисел больше нуля.
8. Щелкните правой кнопкой мыши узел проекта и выберите "Run".

   Теперь в окне "Output" должна отобразиться сумма:

       compile:
       run:
       Result = 7
               BUILD SUCCESSFUL (total time: 1 second)

Клиент 2: сервлет в веб-приложении

В этом разделе будет рассмотрено создание нового веб-приложения и последующее создание сервлета. Затем этим сервлетом будет использоваться веб-служба, созданная в начале этого руководства.

1. Выберите "File > New Project" (Ctrl-Shift-N). Выберите "Web Application" в категории "Web". Присвойте проекту имя CalculatorWSServletClient. Нажмите кнопку "Finish".
2. Щелкните правой кнопкой мыши узел CalculatorWSServletClient и выберите "New > Web Service Client".

   Появится мастер "New Web Service Client".

3. В окне "Project" нажмите кнопку "Browse". Перейдите к веб-службе, которую необходимо использовать. Выберите веб-службу и нажмите кнопку "OK".
4. Оставьте остальные параметры настройки по умолчанию (в 6.0.x не указывайте имя пакета) и нажмите кнопку "Finish".

Узел "Web Service References" в окне "Projects" отражает структуру созданного клиента, включая операцию add, рассмотренную выше в этом руководстве:



5. Щелкните правой кнопкой мыши узел проекта CalculatorWSServletClient и выберите "New > Servlet". Присвойте сервлету имя ClientServlet и поместите его в пакет с именем org.me.calculator.client. Нажмите кнопку "Finish".
6. Чтобы сделать сервлет точкой входа приложения, щелкните правой кнопкой мыши узел проекта, выберите "Properties", нажмите кнопку "Run" и введите /ClientServlet в поле "Relative URL". Нажмите кнопку "OK".
7. В редакторе исходного кода удалите строку с комментарием в теле метода processRequest. Строка имеет следующий вид:

       /* TODO output your page here

   Затем удалите строку, которой заканчивается раздел закомментированного кода:

       */

   После этой строки добавьте несколько пустых:

       out.println("<h1>Servlet ClientServlet at " + request.getContextPath () + "</h1>");

   Теперь переместите на образовавшееся место узел, представляющий операцию add.

   Теперь метод processRequest выглядит следующим образом (добавленный код выделен ниже полужирным шрифтом):

       protected void processRequest(HttpServletRequest request, HttpServletResponse response)
       throws ServletException, IOException {
           response.setContentType("text/html;charset=UTF-8");
           PrintWriter out = response.getWriter();
           out.println("<html>");
           out.println("<head>");
           out.println("<title>Servlet ClientServlet</title>");
           out.println("</head>");
           out.println("<body>");
           out.println("<h1>Servlet ClientServlet at " + request.getContextPath () + "</h1>");
   
           try { // Call Web Service Operation
               org.me.calculator.CalculatorWS port = service.getCalculatorWSPort();
               // TODO initialize WS operation arguments here
               int i = 0;
               int j = 0;
               // TODO process result here
               int result = port.add(i, j);
               out.println("Result = "+result);
           } catch (Exception ex) {
               // TODO handle custom exceptions here
           }
   
           out.println("</body>");
           out.println("</html>");
           out.close();
                       }

   Измените значение i и j на положительные значимые числа, например, на 3 и 4.

8. Щелкните правой кнопкой мыши узел проекта и выберите "Run".

   Запускается сервер (если он не был запущен ранее); после сборки и развертывания приложения открывается обозреватель, в котором отображается результат вычисления, как показано ниже:
   

Клиент 3: страница JSP в веб-приложении

В этом разделе описана процедура создания нового веб-приложения и использование веб-службы на странице JSP по умолчанию, созданной с помощью мастера "Web Application".

1. Выберите "File > New Project" (Ctrl-Shift-N). Выберите "Web Application" в категории "Web". Присвойте проекту имя CalculatorWSJSPClient. Нажмите кнопку "Finish".
2. Щелкните правой кнопкой мыши узел CalculatorWSJSPClient и выберите "New > Web Service Client".
3. В окне "Project" нажмите кнопку "Browse". Перейдите к веб-службе, которую необходимо использовать. Выберите веб-службу и нажмите кнопку "OK".
4. Оставьте остальные параметры настройки по умолчанию (в 6.0.x не указывайте имя пакета) и нажмите кнопку "Finish".

   В окне "Projects" появится новый клиент веб-службы, как показано ниже:

   
   
5. В узле "Web Service References" разверните узел, представляющий веб-службу. Теперь показана операция add, которую требуется вызывать посредством клиента.
6. Перетащите операцию add на страницу клиента index.jsp под теги H1. Теперь на странице index.jsp отображается код для вызова операции службы, показанный ниже:

   <%
   try {
       org.me.calculator.CalculatorWSService service =
           new org.me.calculator.CalculatorWSService();
       org.me.calculator.CalculatorWS port =
           service.getCalculatorWSPort();
        // TODO initialize WS operation arguments here
       int i = 0;
       int j = 0;
       // TODO process result here
       int result = port.add(i, j);
       out.println("Result = "+result);
   } catch (Exception ex) {
       // TODO handle custom exceptions here
   }
   %>

   Измените значения i и j с 0 на положительные значимые числа, например, 3 и 4.

7. Щелкните правой кнопкой мыши узел проекта и выберите "Run".

   Запускается сервер (если он не был запущен ранее); после сборки и развертывания приложения открывается обозреватель, в котором отображается результат вычисления: