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

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

1. Выберите "Файл > Создать проект" (Ctrl-Shift-N в Linux и Windows, ⌘-Shift-N в MacOS). Выберите "Веб-приложение" из категории "Java Web" или "Модуль EJB" из категории "Java EE".

   Веб-службу JAX-WS можно создать в проекте Maven. Выберите "Файл > Создать проект" (Ctrl-Shift-N в Linux и Windows, ⌘-Shift-N в MacOS), затем выберите "Веб-приложение Maven" или "Модуль Maven EJB" из категории "Maven". Если ранее вы не использовали Maven со средой NetBeans, ознакомьтесь с документом Maven Best Practices (Рекомендации по Maven).

2. Дайте проекту имя CalculatorWSApplication. Выберите местоположение для проекта. Нажмите кнопку "Далее".
3. Выберите свой сервер и версию Java EE и щелкните "Готово".

   Для использования сервера Oracle WebLogic зарегистрируйте сервер с помощью среды IDE. Кроме этого, если вы используете сервер WebLogic, просмотрите демо-ролик Deploying a Web Application to Oracle WebLogic (Развертывание веб-приложения на Oracle WebLogic).

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

1. Щелкните правой кнопкой мыши узел CalculatorWSApplication и выберите "Создать > Веб-служба".
2. Присвойте веб-службе имя CalculatorWS и введите org.me.calculator в поле "Пакет". Оставьте установленной кнопку-переключатель "Создать веб-службу с нуля".
3. Если создается проект Java EE 6, выберите "Реализовать веб-службу в качестве сеансного компонента без поддержки состояния".
   
4. Нажмите кнопку "Готово". В окне "Проекты" отображается структура новой веб-службы, а в области редактора отображается исходный код.
   

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

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

1. Выберите "Файл > Создать проект" (Ctrl-Shift-N в Linux и Windows, ⌘-Shift-N в MacOS). Выберите "Приложение Java" в категории "Java". Присвойте проекту имя CalculatorWS_Client_Application. Не снимайте флажок "Создать главный класс" и оставьте все прочие значения по умолчанию. Нажмите кнопку "Готово".
2. Щелкните правой кнопкой мыши узел CalculatorWS_Client_Application и выберите "Создать > Клиент веб-службы". Появится мастер создания клиента веб-службы.
3. Выберите проект в виде исходного файла WSDL. Нажмите кнопку "Обзор". В проекте CalculatorWSApplication перейдите к веб-службе CalculatorWS. Выберите веб-службу и нажмите кнопку "ОК".
   
4. Не выбирайте имя пакета. Оставьте это поле пустым.
   
5. Оставьте значения остальных параметров по умолчанию и нажмите кнопку "Готово".

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

   
   
6. Дважды щелкните главный класс, чтобы открыть его в редакторе исходного кода. Перетащите узел add в местоположение ниже метода main().
   

   На экране должны быть представлены следующие параметры:

   public static void main(String[] args) {
       // TODO code application logic here
   }
   private static int add(int i, int j) {
       org.me.calculator.CalculatorWS_Service service = new org.me.calculator.CalculatorWS_Service();
       org.me.calculator.CalculatorWS port = service.getCalculatorWSPort();
       return port.add(i, j);
   }

   Примечание. Вместо перетаскивания узла add можно щелкнуть правой кнопкой мыши в редакторе и выбрать "Вставка кода > Вызов операции веб-службы".

7. В теле метода main() замените комментарий TODO кодом, который инициализирует значения для i и j, вызывает add() и распечатывает результат.

   public static void main(String[] args) {
       int i = 3;
       int j = 4;
       int result = add(i, j);
       System.out.println("Result = " + result);
   }

8. Окружите код метода main() блоком try/catch, который распечатывает исключение.

   public static void main(String[] args) {
       try {
           int i = 3;
           int j = 4;
           int result = add(i, j);
           System.out.println("Result = " + result);
       } catch (Exception ex) {
           System.out.println("Exception: " + ex);
       }
   }

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

   Теперь в окне "Вывод" отображается сумма:

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

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

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

1. Выберите "Файл > Создать проект" (Ctrl-Shift-N в Linux и Windows, ⌘-Shift-N в MacOS). Выберите "Веб-приложение" в категории "Java Web". Дайте проекту имя CalculatorWSServletClient. Нажмите кнопку "Далее", а затем нажмите кнопку "Готово".
2. Щелкните правой кнопкой мыши узел CalculatorWSServletClient и выберите "Создать > Клиент веб-службы".

   Появится мастер "Новый клиент веб-службы".

3. Выберите проект в виде исходного файла WSDL. Щелкните "Обзор". В проекте CalculatorWSApplication перейдите к веб-службе CalculatorWS. Выберите веб-службу и нажмите кнопку "ОК".
   
4. Не выбирайте имя пакета. Оставьте это поле пустым.
5. Оставьте значения остальных параметров по умолчанию и нажмите кнопку "Готово".

   Узел "Ссылки на веб-службу" в окне "Проекты" отражает структуру созданного клиента, включая операцию add, рассмотренную выше в этом учебном курсе:

   
   
6. Щелкните правой кнопкой мыши узел проекта CalculatorWSServletClient и выберите "Создать > Сервлет". Дайте сервлету имя ClientServlet и поместите его в пакет с именем org.me.calculator.client. Нажмите кнопку "Готово".
7. Чтобы сделать сервлет точкой входа приложения, щелкните правой кнопкой мыши узел проекта "CalculatorWSServletClient" и выберите "Свойства". Откройте "Свойства выполнения" и введите /ClientServlet в поле "Относительный адрес". Нажмите кнопку "ОК".
8. Если для ClientServlet.java появился значок ошибки, щелкните правой кнопкой мыши узел проекта и выберите "Очистить и построить".
9. В редакторе исходного кода перетащите операцию add в любое место тела класса ClientServlet. Метод add() отображается в конце кода класса.

   Примечание. Вместо перетаскивания узла add можно щелкнуть правой кнопкой мыши в редакторе и выбрать "Вставка кода > Вызов операции веб-службы".

   private int add(int i, int j) {
       org.me.calculator.CalculatorWS port = service.getCalculatorWSPort();
       return port.add(i, j);
   }

10. В методе processRequest() добавьте несколько пустых строк после следующей строки:

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

11. Добавьте код, который инициализирует значения для i и j, вызывает add() и распечатывает результат. Добавленный код выделяется полужирным начертанием:

    protected void processRequest(HttpServletRequest request, HttpServletResponse response)
             throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        try {
            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>");
    
            int i = 3;
            int j = 4;
            int result = add(i, j);
            out.println("Result = " + result);
    
           out.println("</body>");
            out.println("</html>");
            
        } finally {            
            out.close();
        }
    }

12. Окружите добавленный код блоком try/catch, который распечатывает исключение.

    protected void processRequest(HttpServletRequest request, HttpServletResponse response)
             throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        try {
            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 {
                int i = 3;
                int j = 4;
                int result = add(i, j);
                out.println("Result = " + result);
            } catch (Exception ex) {
                out.println("Exception: " + ex);
            }
            out.println("</body>");
            out.println("</html>");
            
        } finally {            
            out.close();
        }
    }

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

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

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

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

Примечание. Если веб-приложение JSP требуется запустить на Oracle WebLogic, обратитесь к документу Running a Java Server Faces 2.0 Application on WebLogic (Выполнение приложения a Java Server Faces 2.0 на WebLogic).

1. Выберите "Файл > Создать проект" (Ctrl-Shift-N в Linux и Windows, ⌘-Shift-N в MacOS). Выберите "Веб-приложение" в категории "Java Web". Дайте проекту имя CalculatorWSJSPClient. Нажмите кнопку "Готово".
2. Щелкните правой кнопкой мыши узел CalculatorWSJSPClient и выберите "Создать > Клиент веб-службы".
3. Выберите проект в виде исходного файла WSDL. Щелкните "Обзор". В проекте CalculatorWSApplication перейдите к веб-службе CalculatorWS. Выберите веб-службу и нажмите кнопку "ОК".
   
4. Не выбирайте имя пакета. Оставьте это поле пустым.
5. Оставьте значения остальных параметров по умолчанию и нажмите кнопку "Готово".

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

   
   
6. В узле "Ссылки на веб-службы" разверните узел, соответствующий веб-службе. Теперь показана операция add, которую требуется вызывать посредством клиента.
7. Перетащите операцию 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 инициализация аргументов операции веб-службы
       int i = 0;
       int j = 0;
       // TODO обработка результата
       int result = port.add(i, j);
       out.println("Результат = "+result);
   } catch (Exception ex) {
       // TODO обработка собственных исключений
   }
           %>

   Измените значения для i и j с 0 на другие целые числа, например, на 3 и 4. В блоке "catch" замените закомментированную строчку "TODO" на out.println("exception" + ex);.

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

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