Содержание


Java EE, следующая ступень

Руководство по установке локальной среды разработки приложений Java EE для WebSphere Liberty

Будьте готовы дать свободу своим приложениям

Comments

Серия контента:

Этот контент является частью # из серии # статей: Java EE, следующая ступень

Следите за выходом новых статей этой серии.

Этот контент является частью серии:Java EE, следующая ступень

Следите за выходом новых статей этой серии.

Профиль Liberty IBM WebSphere Application Server – это архитектура следующего поколения сервера приложений WebSphere Application Server. Чтобы разрабатывать приложения для этого сервера, вам потребуется локальная среда разработки, которая включает в себя Liberty – но, поскольку Liberty отличается высокой степенью компонуемости, для выбора правильной версии установочного дистрибутива вам необходимы базовые знания принципов работы Liberty.

Данное обучающее пособие рассказывает о том, как с помощью Eclipse и Liberty установить и настроить локальную среду разработки для создания и тестирования приложений Java Platform, Enterprise Edition (Java EE). Данный процесс поможет вам создать действующую среду разработки, с помощью которой можно будет создавать приложения для Liberty.

Данное обучающее пособие является вторым в серии пособий, посвященных установке локальной среды разработки на основе Eclipse и Liberty. Эта группа обучающих пособий включает в себя:

  1. Вводное пособие по WebSphere Liberty для разработчиков Java EE
  2. Руководство по установке локальной среды разработки приложений Java EE для WebSphere Liberty (данный документ)
  3. Руководство по установке локальной среды разработки приложений Java EE для Bluemix

Статья предполагает, что читатель уже знаком с первым обучающим пособием из данной серии.

Зачем нужно устанавливать среду разработки Liberty?

Потребность в создании локальной среды разработки Java EE, использующей Liberty в качестве сервера приложений, может возникнуть по двум основным причинам:

  • Серверы Liberty имеют небольшой размеры, просты в установке и администрировании.
  • Все больший объем исполняющего кода, используемого в промышленных инфраструктурах, имеет в своей основе Liberty.

Как было показано ранее в этой серии, из серверов Liberty получаются отличные серверы для локального тестирования приложений Java EE. Эти серверы отличаются исключительной компактностью, благодаря чему сразу несколько таких серверов могут спокойно работать на настольном компьютере параллельно с другими приложениями. Наличие целиком подконтрольных вам локальных серверов облегчает процесс тестирования. При этом серверы Liberty просты в установке и настройке и поддерживают возможность обновления без перезагрузки сервера. Для того, чтобы развернуть приложение, достаточно просто поместить архив в нужный каталог или выполнить процедуру развертывания средствами Eclipse. Как объясняет, Том Олкот (Tom Alcott), исторически одним из наиболее распространенных сценариев использования Liberty было создание сред разработки на настольных компьютерах, которые служат для разработки приложений Java EE, предназначенных для развертывания на полном профиле сервера WebSphere Application Server для формального тестирования и промышленной эксплуатации.

Сегодня промышленная инфраструктура тоже "переезжает" на Liberty. Liberty все чаще используют в качестве промышленной среды времени исполнения для корпоративных приложений из-за высокой эффективности использования ресурсов, удобства администрирования и широких возможностей масштабирования. Для системы Docker образы IBM Liberty создают контейнеры, которые выполняют сервер приложений и при этом сохраняют небольшие размеры. Для облачных приложений мгновенный код исполнения Bluemix Liberty for Java и IBM Liberty Image имеют в своей основе (как подразумевают их названия) Liberty. Чтобы избежать несоответствия между средой разработки и промышленной средой, бывает полезно создать среду разработки, которая максимально близка к промышленной. Следовательно, при разработке приложения, рассчитанного на развертывание в исполняющем коде Liberty в промышленной инфраструктуре, бывает полезно использовать Liberty в качестве среды разработки. Повсеместное использование Liberty означает, что ваши приложения можно будет развернуть где угодно, и они везде будут вести себя одинаково.

Теперь, когда вам понятно, почему Liberty отлично подходит на роль локальной среды разработки, рассмотрим процесс ее установки.

Данное обучающее пособие описывает два основных этапа установки Liberty и Eclipse:

  1. РазделУстановка среды разработки описывает общий процесс установки Eclipse и Liberty, а также подключение Eclipse к Liberty в качестве исполняющего кода для приложений.
  2. Раздел Типовые задачи 2. описывает установочные задачи общего характера по настройке Eclipse и Liberty. Возможно, вам уже известно, что нужно делать, если вы знакомы с Eclipse и Liberty, соответственно, описание действий в этом разделе адресовано тем, кто продолжает обучение и нуждается в дополнительной информации. Некоторые действия будут выполнены сразу же, в процессе установки, некоторые – позже, в процессе адаптации среды разработки для решения различных задач, таких, как разработка приложений с различными программными моделями.

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

Установка среды разработки

При разработке приложений Java для Liberty полезно иметь локальную среду разработки, которая включает в себя не только среду исполнения Liberty, но и средства разработки Eclipse. В данном разделе рассматривается процедура установки и настройки среды разработки, состоящей из Eclipse и Liberty.

Чтобы установить Liberty и Eclipse, необходимо:

  1. Выбрать каталоги для установки
  2. Установить JDK
  3. Установить профиль Libertye
  4. Установить Eclipse
  5. Установить WebSphere Developer Tools
  6. Установить сервер Liberty в среде Eclipse

Ниже эти шаги будут рассмотрены более подробно.

1. Выбор каталогов для установки

Первый вопрос состоит в том, куда нужно установить Eclipse и Liberty? Среда исполнения Java (JRE, JDK или SDK) представляет собой исполняемый файл, интегрированная среда разработки Eclipse также устанавливается в виде исполняемого файла, поэтому обычно их устанавливают в каталог по умолчанию для приложений или программных файлов данного компьютера. Для Eclipse, однако, нужен каталог рабочих пространств (workspace), а для Liberty – установочный каталог. Где должны находиться эти каталоги?

В принципе, можно выбрать любые каталоги, и в большинстве ситуаций никаких проблем не возникнет. В Таблице 1 приведен пример рабочей структуры каталогов. (В имени каталога необходимо учесть номер установленной версии Liberty. В частности, имя каталога wlp указанного в данном примере, подразумевает, что установлена версия Liberty v8.5.5.6.)

Таблица 1. Пример структуры каталогов для установки
КаталогНазначение
/devВсе артефакты разработки
/dev/ApplicationServersСерверные продукты
/dev/ApplicationServers/wlp-8.5.5.6Профиль Liberty v8.5.5.6
/dev/EclipseАртефакты Eclipse
/dev/Eclipse/workspaceРабочее пространство Eclipse по умолчанию
/dev/gitПроекты из Git

Независимо от выбранной структуры каталогов данному процессу установки потребуются следующие два каталога:

  • <Liberty_Root> – Каталог для установки Liberty

    Например: /dev/ApplicationServers/wlp-8.5.5.6

  • <Eclipse_Workspace> – Каталог для создания рабочего пространства Eclipse

    Например: /dev/Eclipse/workspace

2. Установка JDK

Для работы Liberty необходима отдельно установленная среда JRE, а для работы Eclipse нужен JDK. JDK включает в себя JRE, поэтому для выполнения двух требований, указанных выше, достаточно установить JDK. Приведенные ниже ресурсы могут быть вам полезны:

Установка JDK, который будут использовать Liberty и Eclipse, завершена.

3. Установка профиля Liberty

Для локального прогона и тестирования приложений вам потребуется локальные профиль и сервер Liberty. Обратите внимание, что в рамках данной процедуры установка полного продукта WebSphere Application Server (который включает в себя полный профиль и профиль Liberty) не выполняется. Вместо этого устанавливается сборка Liberty для разработчиков, которая включает в себя только профиль Liberty. Эта сборка имеет меньший размер и быстро устанавливается:

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

Чтобы установить скачанную сборку Liberty, просто распакуйте архив. Разместите целевой каталог wlp в каком-нибудь удобном месте, например, в каталоге <Liberty_Root>. В сборке Liberty Java EE 7 функциональная группа javaee-7.0 по умолчанию включена в диспетчере функциональных групп.

Документацию к Liberty можно найти на странице Обзор профиля Liberty в WebSphere Application Server (распределенная ОС и ОС IBM i), версия 8.5.5..

Профиль Liberty установлен в каталоге <Liberty_Root>/wlp.

4. Установка Eclipse

При разработке приложений Java для сервера Liberty удобно иметь интегрированную среду разработки (IDE). Существует несколько вариантов таких сред, из которых можно выбрать наиболее подходящий для вас. В данном обучающем пособии рассматривается среда Eclipse: во-первых, потому что она бесплатна, во-вторых, потому, что данное пособие использует некоторые полезные комплекты инструментов для разработчиков Java от IBM, которые работают в Eclipse.

Установите интегрированную среду разработки Eclipse для разработчиков Java EE:

  • Свежую версию Eclipse (на момент написания данного документа – это версия с кодовым наименованием Mars) можно скачать на этой странице Компоненты Eclipse для скачивания.
  • Установите данный пакет: Eclipse IDE for Java EE Developers.
  • Наиболее простой вариант – воспользоваться установщиком Eclipse, Eclipse Installer. Кроме того, можно скачать и установить пакет Eclipse (Eclipse Package), следуя инструкциям на странице Eclipse/Установка .

Установка Eclipse и средств разработки Java завершена, теперь их можно запустить.

О том, как запустить Eclipse, можно узнать в разделе Запуск Eclipse в документации Eclipse к текущей версии.

Теперь среда Eclipse установлена и запущена.

5. Установка WebSphere Developer Tools

Инструменты WebSphere Developer Tools облегчают развертывание приложений с помощью Eclipse на серверах WebSphere Application Server, в том числе в профиле Liberty.

  • Скачайте и установите WebSphere Developer Tools для используемой вами версии Eclipse. Версию для Mars можно найти на странице WebSphere Developer Tools for Eclipse Mars.

Для скачивания и установки WebSphere Developer Tools можно также воспользоваться кнопкой Install для WAS Liberty Profile V8.5.5. Перетащите ее с веб-страницы в окно Eclipse.

Документацию можно найти на страницеIBM WebSphere Developer Tools, версия 8.5..

Установка WebSphere Developer Tools для среды Eclipse завершена.

6. Установка сервера Liberty в среде Eclipse

После установки локального профиля Liberty вам потребуется установить сервер Liberty, а затем подключиться к нему из среды Eclipse, с тем, чтобы иметь возможность воспользоваться его ресурсами в среде Eclipse.

Для создания сервера Liberty необходимо создать следующие элементы (наименования приведены для версии Liberty v8.5.5.6):

  • Среда времени исполнения в Eclipse – Имя: wlp-8.5.5.6, путь: <Liberty_Root>/wlp.
  • Сервер в профиле Liberty – Имя: defaultServer.
  • Сервер в Eclipse – Имя: wlp-8.5.5.6 defaultServer at localhost.на локальном хосте (localhost).

Опытные пользователи могут сделать это с помощью диалогового окна New Server. Пошаговое описание процесса приведено ниже.

Процесс создания сервера Liberty завершен, сервер доступен из среды Eclipse.

Завершено

Итак, к настоящему моменту была проведена установка Liberty и Eclipse, и между ними настроена связь, позволяющая развертывать приложения на сервере Liberty из среды Eclipse. В следующем разделе описаны типовые задачи, которые можно решать используя связку Eclipse и Liberty.

Типовые задачи

В последующих разделах приводится описание задач, с которыми чаще всего приходится сталкиваться в ходе применения концепций, описанных в предыдущем обучающем пособии, Вводное пособие по WebSphere Liberty для разработчиков Java EE. К числу таких задач относятся:

Перед тем, как приступить к выполнению указанных задач, необходимо установить профиль Liberty и убедиться в его работоспособности. Eclipse также предлагает инструменты для выполнения многих из этих задач; соответственно, на вашем компьютере должен быть локально установлен Eclipse в сочетании с WebSphere Developer Tools.

Большинство перечисленных выше задач можно выполнить двумя способами:

  • С помощью командной строки – Посредством запуска текстовых команд в окне терминала
  • С помощью интегрированной среды разработки Eclipse – С использованием графических представлений и пошаговых мастеров Eclipse, вызываемых из меню

Независимо от выбранного метода результат будет одинаков; графический интерфейс пользователя и команды реализованы с помощью одних и тех же методов API Liberty. Выбор метода зависит от личных предпочтений; при желании можно переходить от одного метода к другому.

Создание сервера с использованием Eclipse

После установки профиля Liberty вам необходимо создать в этом профиле как минимум один сервер. Задача "Создание сервера с использованием командной строки" описывает процесс создания сервера без использования Eclipse. Чтобы использовать сервер, созданный с помощью командной строки, в среде Eclipse, вам потребуется выполнить все остальные шаги для связки среды Eclipse с профилем и сервером.

Шаги, приведенные ниже, описывают процесс настройки сервера Liberty в среде Eclipse с использованием установленного ранее локального профиля Liberty. Все их можно выполнить в одном диалоговом окне под названием New Server (см. страницу Начало работы с WebSphere Developer Tools for Eclipse and Liberty), но если вы не знакомы с Eclipse и Liberty, возможно, этот процесс вам покажется более легким для понимания, поскольку он создает артефакты путем последовательного выполнения отдельных шагов:

  1. Создание среды времени исполнения в Eclipse, которая связана с профилем Liberty.
  2. Создание сервера в профиле Liberty.
  3. Создание в среде Eclipse сервера, который связан с сервером Liberty.

Эти шаги предполагают, что вы используете Eclipse в качестве интегрированной среды разработки Java с установленными инструментами WebSphere Developer Tools. В ходе выполнения этих шагов необходимо использовать целый ряд переменных, перечисленных в Таблице 2. Значения переменных в настоящем примере приведены для версии 8.5.5.6 профиля Liberty.

Таблица 2. Переменные, используемые при создании сервера Eclipse
ПеременнаяОписаниеПример
<Liberty_Path>Путь установки профиля Liberty. Как правило, последний каталог называется wlp..../wlp-8.5.5.6/wlp
<Environment_Name>Название среды времени исполнения в Eclipse. Как правило, это имя указывает на номер версии профиля Liberty.wlp-8.5.5.6
<Liberty_Server_Name>Имя сервера, который будет создан в профиле Liberty, установленном в каталоге <Liberty_Path>.defaultServer
<Eclipse_Server_Name>Имя сервера в Eclipse. Как правило, имя сервера в Eclipse соответствует имени сервера в профиле Liberty; если сервер установлен локально, то его имя оканчивается строкой “at localhost”.wlp-8.5.5.6 defaultServer at localhost

Создание сервера с помощью командной строки

Во-первых, вам нужно создать среду времени исполнения в Eclipse, которая связана с установленным локально профилем Liberty. С помощью WebSphere Developer Tools в среде Eclipse:

  1. В представлении Runtime Explorer выберите New > Runtime Environment ( рисунок 1).
    Рисунок 1. Новая среда времени исполнения
    New runtime environment
    New runtime environment
  2. В диалоговом окне Liberty Profile (рисунок 2):
    • Установите значение поля Name равным <Environment_Name>.
    • Выберите опцию Choose an existing installation установите значение поля Path равным <Liberty_Path>.
    • Выберите опцию Use default JRE (или укажите JRE, который нужен вашим приложениям).
    • Нажмите кнопку Finish.
    Рисунок 2. Создание среды времени исполнения
    Create runtime environment
    Create runtime environment

Процедура привязки среды времени исполнения в Eclipse к профилю Liberty, установленному вовне Eclipse. Следующий шаг – создание сервера и связи с ним из среды Eclipse.

Создание сервера Liberty

Следующим шагом нужно создать сервер в профиле Liberty. Если у вас уже имеется существующий сервер, перейдите к следующему шагу для создания связи с ним из среды Eclipse. Если вам нужно создать сервер в профиле, с которым уже установлена связь из среды Eclipse, это можно сделать здесь.

Чтобы создать сервер в профиле с использованием WebSphere Developer Tools в Eclipse, проделайте следующее:

  1. В представлении Runtime Explorer выберите только что созданную среду времени исполнения, <Environment_Name>. Выберите New > Liberty Profile Server ( рисунок 3).
    Рисунок 3. Новый сервер в профиле Liberty
    New Liberty profile server
    New Liberty profile server
  2. В диалоговом окне New Liberty Profile Server (рисунок 5):
    • Подтвердите, что значение параметра User directory следует установить равным <Environment_Name>.
    • Установите значение параметра Server name равным <Liberty_Server_Name>.
    • Подтвердите, что значение параметра Template следует установить равным defaultServer.
    • Нажмите кнопку Finish.
    Рисунок 4. Создание сервера в профиле Liberty
    Create Liberty profile server
    Create Liberty profile server

Процедура создания сервера в профиле Liberty с использованием средств Eclipse завершена. На следующем шаге необходимо сделать этот сервер доступным в среде Eclipse.

Создание сервера в среде Eclipse

Чтобы создать в среде Eclipse сервер, который имеет связь с локально установленным сервером Liberty, с помощью WebSphere Developer Tools в Eclipse, проделайте следующее:

  1. В представлении Servers выберитеNew > Server.
  2. На странице Define a New Server в диалоговом окне New Server (рисунок 5):
    • Выберите Server Type IBM > WebSphere Application Server Liberty Profile.
    • Подтвердите, что значение поля Server’s host name следует установить равным localhost.
    • Выберите Server runtime environment <Environment_Name>.
    • Установите значение поля Server name равным <Eclipse_Server_Name>.
    • Нажмите кнопку Next.
    Рисунок 5. Создание нового сервера
    Define a new server
    Define a new server
  3. На панели Liberty Profile Server (рисунок 6):
    • Подтвердите, что значение поля Liberty profile server следует установить равным <Liberty_Server_Name>.
    • Нажмите кнопку Finish.
    Рисунок 6. Сервер в профиле Liberty
    Liberty profile server
    Liberty profile server

Итак, к настоящему моменту вы создали сервер под названием <Liberty_Server_Name> в профиле Liberty, установленном в каталоге <Liberty_Path>, а затем установили связь с ним из среды Eclipse под названием <Eclipse_Server_Name> в среде времени исполнения <Environment_Name>.Новый сервер установлен по следующему пути:

<Liberty_Path>/usr/servers/<Liberty_Server_Name>

Eclipse имеет связь с этим сервером, поэтому среду Eclipse можно использовать для управления сервером. Это означает, что у вас имеется возможность разворачивать проекты Eclipse на этом сервере.

Создание сервера с помощью командной строки

После установки профиля Liberty вам необходимо создать в этом профиле как минимум один сервер. Эта задача описывает процесс создания сервера из командной строки без использования Eclipse. Задача "Создание сервера в среде Eclipse" показывает, как создать сервер, чтобы его можно было использовать в среде Eclipse. Чтобы использовать сервер, созданный с помощью командной строки, в среде Eclipse, вам потребуется выполнить все необходимые шаги этой задачи для связки среды Eclipse с профилем и сервером.

В ходе выполнения этих шагов необходимо использовать переменные, перечисленные в Таблице 3. Значения переменных в настоящем примере приведены для версии 8.5.5.6 профиля Liberty.

Таблица 3. Переменные, используемые при создании сервера
ПеременнаяОписаниеПример
<Liberty_Path>Путь установки профиля Liberty. Как правило, последний каталог называется wlp..../wlp-8.5.5.6/wlp
<Liberty_Server_Name>Имя сервера, который будет создан в профиле Liberty, установленном в каталоге <Liberty_Path>.defaultServer

Чтобы создать в профиле сервер с помощью командной строки, выполните команду server create, чтобы создать сервер, и укажите строку <Liberty_Server_Name> в качестве имени сервера. Имя сервера по умолчанию – defaultServer.

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

<Liberty_Path>/bin/server create <Liberty_Server_Name>

Например:

cd wlp-8.5.5.6
wlp/bin/server create defaultServer

Эта команда создает сервер с именем <Liberty_Server_Name> в профиле Liberty, который установлен в каталоге <Liberty_Path>. Новый сервер установлен по следующему пути:

<Liberty_Path>/usr/servers/<Liberty_Server_Name>

Теперь на этом сервере можно разворачивать приложения в соответствии с описанием из раздела Развертывание веб-приложения на сервере Liberty.

Скачивание ресурсов

После установки Liberty можно установить дополнительные ресурсы в профиле Liberty. Если Liberty установлен в паре с Eclipse, то для установки ресурсов можно воспользоваться дополнительными инструментами.

Скачать любой из ресурсов для любой из функциональных групп, перечисленных на странице Репозиторий IBM WebSphere Liberty Repository: функциональные группы ; можно с помощью командной строки; тот же самый список ресурсов функциональных групп можно увидеть и в графическом интерфейсе пользователя Eclipse. На этой веб-странице можно найти не только список ресурсов для функциональных групп, но и инструкции по их скачиванию и установке, которые также рассматриваются в настоящем документе.

Рассмотрим процедуру установки ресурса на примере. Пользователи новой версии Liberty часто интересуются, что произошло с консолью интегрированных решений, Integrated Solutions Console (ранее известной как административная консоль или консоль администратора). В Liberty пользовательский веб-интерфейс называется Admin Center, и, как и большинство функциональных групп в Liberty, он носит опциональный характер; т.е., функциональную группу Admin Center для сервера можно загрузить только в том случае, если ее планируется реально использовать.

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

Командная строка: Список функциональных групп

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

Чтобы скачать и установить ресурс Admin Center из командной строки, выполните следующую команду:

wlp/bin/installUtility install adminCenter-1.0

Эта команда инициирует скачивание и установку указанных функциональных групп, в данном случае – одной функциональной группы под названием adminCenter-1.0.

Командная строка: Конфигурация сервера

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

<feature>adminCenter-1.0</feature>

Предположим, что имя конфигурируемого сервера – defaultServer. Для включения данной функциональной группы измените файл server.xml данного сервера. Затем, чтобы удостовериться, что профиль содержит ресурсы для всех функциональных групп, включенных для сервера defaultServer (в том числе для adminCenter-1.0), можно выполнить следующую команду:

wlp/bin/installUtility install --acceptLicense defaultServer

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

Графический интерфейс пользователя Eclipse

Чтобы скачать и установить ресурс Admin Center с помощью инструментов WebSphere Developer Tools в среде Eclipse, проделайте следующее:

  1. 1. В представлении Runtime Explorer выберите среду времени исполнения, соответствующую профилю, в который требуется установить ресурс.
  2. После того, как вы указали среду времени исполнения, выберите опцию Install Additional Content (ранее она называлась Install Add-Ons), 2. как показано на Рисунке 7.
    Рисунок 7. Установка дополнительного содержимого
    Install additional content
    Install additional content
  3. В диалоговом окне Install Additional Content найдите ресурс, который нужно скачать и установить. В данном примере ресурс называется Admin Center. Нажмите кнопку Install (Рисунок 8) .
    Рисунок 8. Установка дополнительного содержимого
    Install additional content
    Install additional content
  4. Нажмите кнопку Next, подтвердите согласие с лицензией, а затем нажмите кнопку Finish чтобы скачать и установить ресурс.

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

Включение функциональных групп

Конфигурация сервера по умолчанию предполагает только запуск ядра, без каких-либо функциональных групп. (Ядро запускается очень быстро и потребляет минимальный объем памяти.) Чтобы сервер мог выполнять какую-либо полезную работу, необходимо в дополнение к ядру загрузить определенные функциональные группы. Как было пояснено выше, перечень включенных (т.е., разрешенных для загрузки) функций указывают в разделе Feature manager (Диспетчер функциональных групп) серверной конфигурации.

Конфигурация сервера хранится в XML-файле server.xml, который находится в каталоге wlp/usr/servers/<server-name>. Его XML-схема включает в себя элемент <featureManager> который описывает функциональные группы, доступные для загрузки на данном сервере. Для того, чтобы сервер мог загрузить определенную функциональную группу, ресурс, соответствующий данной функциональной группе, должен быть уже установлен в данном профиле.

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

Командная строка

Чтобы воспользоваться командной строкой, откройте файл server.xml с помощью текстового редактора или XML-редактора на ваш выбор, внесите изменения в файл, как показано ниже на примере редактора Source editor в среде Eclipse.

Графический интерфейс пользователя Eclipse

В среде Eclipse найдите файл конфигурации сервера и откройте его для редактирования.

  1. В представлении Servers выберите сервер, настройки которого необходимо изменить.
  2. 2. Разверните информацию о сервере, чтобы просмотреть связанные с ним проекты и конфигурационные файлы. Выберите файл Server Configuration [server.xml] и откройте его в редакторе (рисунок 9).
    Рисунок 9. Запуск редактора конфигурации сервера
    Open the server configuration editor
    Open the server configuration editor

Редактор конфигурации сервера – Server Configuration editor – имеет два представления, Design и Source. Для внесения изменений в конфигурацию сервера можно воспользоваться любым из них или обоими сразу.

Чтобы вывести на экран и отредактировать содержимое XML-файла, проделайте следующее:

  1. Выберите представление Source (рисунок 10). Конфигурация диспетчера функциональных групп будет выглядеть примерно так:
    <featureManager>
        <feature>javaee-7.0</feature>
    </featureManager>
    Рисунок 10. Редактор конфигурации сервера: Источник
    Server configuration editor: Source
    Server configuration editor: Source
  2. 4. Чтобы добавить Admin Center в список диспетчера функциональных групп, добавьте в приведенный выше фрагмент следующую строку:
    <feature>adminCenter-1.0</feature>

    В результате добавления этой строки конфигурация диспетчера функциональных групп теперь будет выглядеть так: this:

    <featureManager>
        <feature>javaee-7.0</feature>
        <feature>adminCenter-1.0</feature>
    </featureManager>

    Эти две строки указывают серверу на то, что ему необходимо загрузить функциональные группы javaee-7.0 и adminCenter-1.0 .

Чтобы внести изменения в конфигурацию диспетчера функциональных групп с помощью инструмента Server Configuration Designer, проделайте следующее:

  1. Выберите представлениеDesign . В структуре Server Configuration выберите Feature Manager. Представление Feature Manager будет содержать перечень компонентов, который выглядит так, как показано на рисунке 11:
    Таблица 4. Список в представлении Feature Manager
    Функциональная группаНазвание
    javaee-7.0Java EE Full Platform 7.0
    Рисунок 11. Редактор конфигурации сервера: Design
    Server configuration editor: Design
    Server configuration editor: Design
  2. Нажмите кнопку Add.
  3. Откроется диалоговое окно Add Features, содержащее список всех функциональных групп, установленных в данном профиле, которые отсутствуют в списке диспетчера функциональных групп (рисунок 12). Выберите требуемую функциональную группу, как показано на рисунке ниже, и нажмите кнопку OK чтобы ее добавить:
    Таблица 5. Список в диалоговом окне Add Features
    Функциональная группаНазвание
    adminCenter-1.0Admin Center 1.0
    Рисунок 12. Диалоговое окно Add features
    Add features dialog
    Add features dialog

    Теперь в представлении Feature Manager (рисунок 13) присутствуют эти компоненты:

    Таблица 6. Список в представлении Feature Manager
    Функциональная группа Название
    javaee-7.0Java EE Full Platform 7.0
    adminCenter-1.0Admin Center 1.0
    Рисунок 13. Представление Feature manager
    Feature manager view
    Feature manager view

Более подробную информацию о работе с редактором конфигурации сервера можно найти на странице Редактирование конфигурации профиля Liberty с помощью инструментов разработчика .

После добавления в список диспетчера функциональных групп функциональная группа Admin Center считается включенной для данного сервера и может быть им загружена. Чтобы открыть Admin Center в браузере, нужно набрать в строке адреса адрес по умолчанию https://localhost:9443/adminCenter/.

Feature not recognized (Не удалось распознать функциональную группу)

При включении функциональной группы Eclipse может вывести на экран предупредительное сообщение "feature not recognized" ("Не удалось распознать функциональную группу"), например:

Таблица 7. Feature not recognized (Не удалось распознать функциональную группу)
ОписаниеСпециалистПуть
Не удалось распознать функциональную группу 'wasJmsClient-1.1'server.xml/wlp-8.5.5.6/servers/defaultServer

Предупредительное сообщение отображается в редакторе конфигурации сервера (Server Configuration Editor) и в представлении Problems, как показано на Рисунке 14.

Рисунок 14. Предупредительное сообщение Feature not recognized (Не удалось распознать функциональную группу)
Feature not recognized warning
Feature not recognized warning

Это предупредительное сообщение означает, что для указанной функциональной группы в профиле отсутствуют ресурсы. Сервер не сможет загрузить эту функциональную группу, если ресурса нет в профиле. Чтобы устранить проблему, нужно скачать ресурс, соответствующий данной функциональной группе, в профиль сервера, как описано в разделе "Скачивание ресурса".

Пакетирование сервера

Как было пояснено ранее, в процессе пакетирования сервера создается компактный архив, который содержит все необходимое для установки приложения и связанной с ним серверной конфигурации на другом компьютере. Для пакетирования сервера можно воспользоваться командной строкой или инструментами WebSphere Developer Tools в среде Eclipse. Перед пакетированием сервера необходимо убрать все ненужные функциональные группы из списка включенных функциональных групп диспетчера функциональных групп, чтобы сделать архив максимально компактным.

Командная строка

Чтобы выполнить пакетирование сервера с именем defaultServer из командной строки, остановите сервер, а затем выполните эту команду:

wlp/bin/server package defaultServer --include=usr

В результате выполнения этой команды будет создан пакетный файл с сервером:

wlp/usr/servers/defaultServer/defaultServer.zip

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

Графический интерфейс пользователя Eclipse

Чтобы выполнить пакетирование сервера с использованием инструментов WebSphere Developer Tools в среде Eclipse, проделайте следующее:

  1. В представлении Servers выберите сервер, для которого необходимо провести пакетирование.
  2. Разверните информацию о сервере, чтобы просмотреть связанные с ним проекты. Это – приложения, которые войдут в пакет вместе с сервером, поэтому удалите те из них, которые в пакет включать не нужно.
  3. Если сервер в данный момент запущен, остановите его.
  4. После того, как вы указали сервер, выберите Utilities > Package Server (рисунок 15).
    Рисунок 15. Меню Package server (Пакетирование сервера)
    Package server menu
    Package server menu
  5. В диалоговом окне Package Server (рисунок 16) проделайте следующее:
    • Укажите архивный файл, который нужно создать.
    • Выберите опцию, определяющую, какие из компонентов сервера нужно включить в пакет, например, No runtime (usr).
    • Нажмите кнопку Finish.
    Рисунок 16. Диалоговое окно Package server
    Package server dialog
    Package server dialog

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

Заключение

В настоящем обучающем пособии были рассмотрены вопросы установки и настройки локальной среды разработки приложений Java с использованием Eclipse и Liberty. Кроме того, было показано, как выполнять типовые задачи по настройке Eclipse и Liberty. Эти знания позволят вам во всеоружии подойти к процессу разработки и развертывания приложений Liberty.

Следующая статья в данной серии Руководство по установке локальной среды разработки приложений Java EE для Bluemix..

Благодарности

Автор хотел бы выразить благодарность следующим сотрудникам IBM за помощь в написании данной статьи: Дэвиду Карри (David Currie), Россу Пэвиту (Ross Pavitt), Рику Осовски (Rick Osowski), Пэм Гайгер (Pam Geiger), Буди Дармавану (Budi Darmawan), Хизер Нельсон (Heather Nelson) и Дэйву Тиссену (Dave Thiessen) .

Ресурсы

WASdev – The WebSphere Application Server Developers Community

WebSphere Application Server (Distributed and IBM i operating systems), Version 8.5.5 documentation


Ресурсы для скачивания


Комментарии

Войдите или зарегистрируйтесь для того чтобы оставлять комментарии или подписаться на них.

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=40
Zone=WebSphere, Облачные вычисления
ArticleID=1041423
ArticleTitle=Java EE, следующая ступень: Руководство по установке локальной среды разработки приложений Java EE для WebSphere Liberty
publish-date=12272016