Разработка в Eclipse
Если вы используете Eclipse в качестве IDE для разработки, то этот небольшой мануал поможет вам настроить окружение для разработки модулей для Агрегата.
Если вы планируете работать над уже существующим модулем Агрегата или API или создать новый, который хотели бы добавить в основной репозиторий Агрегата.
JDK 8 или выше, Git и Eclipse for Java developers.
Для начала необходимо сделать форк репозитория Агрегат в свой репозиторий. Тогда вы сможете публиковать ваш код и присылать Pull Request-ы для включения вашего кода в основной репозиторий Агрегата.
Нажмите кнопку Fork в правом верхнем углу на странице репозитория проекта Агрегат.
После того как GitHub создаст ваш новый репозиторий со всем кодом Агрегата, скопируйте URL этого репозитория.
Теперь нужно сделать так, чтобы код оказался в вашем проекте Eclipse.
Если вы не любитель командной строки и не хотите использовать ее для клонирования репозитория из GitHub, то это можно проделать через интерфейс Eclipse.
Для этого в Eclipse откройте перспективу Git (Window - Perspective - Open perspective - Other - Git).
В открывшемся окне нажмите Clone a Git repository. Откроется окно, где в поле URI нужно вставить скопированный ранее URL вашего репозитория (форка от Агрегата). Можете не заполнять поля имени пользователя и пароля. Выберите удобную для вас директорию, в которую будет клонирован код репозитория.
Клонируйте только ветку master. Именно в ней находится самый свежий код модулей и API.
Если вы желаете работать над уже существующим проектом или API, или если хотите просто использовать существующие модули в качестве примеров, то нужно импортировать их в Eclipse.
Только что мы клонировали код. Теперь снова переключитесь в перспективу Java (Default). В контекстном меню перспективы нажмите Import. В открывшемся окне раскройте папку Maven и выберите Existing Maven projects.
В открывшемся окне выберите папку с нужным модулем из той директории, куда вы клонировали код Агрегата. После этого модуль появится в вашем дереве проектов слева.
Вы можете добавить столько модулей, сколько необходимо.
Для того, чтобы собрать Java модуль, нажмите правой кнопкой на нужном модуле и выберите Run As - Maven install. После сборки проекта в папке target появится собранный файл модуля, который можно поместить в директории deploy вашего Агрегата.
Чтобы собрать модуль, написанный на другом языке, просто создайте zip архив со всеми файлами проекта.
Проверьте, что в настройках Eclipse выбран JDK, а не JRE. Зайдите в Window - Preferences - Java - Installed JRE. Установите там JDK и поставьте на нем галочку.
При разработке модуля необходимо уметь отлаживать код. Для этого запустите Агрегат с помощью скрипта со словом debug в названии. Для Windows - это файл start_debug.bat. Для Mac OS и Linus - start_debug.sh.
Агрегат стартует с включенным дебагером на порту 5555. В Eclipse добавьте конфигурацию дебага "Remote Java Application". Укажите в настройках порт 5555. После этого можно запускать эту конфигурацию и ставить точки останова там где вам это необходимо.
Нажмите File - New - Project. В открывшемся окне раскройте Maven и выберите Maven Project.
Укажите желаемый groupId и artifactId. А также версию модуля. Обязательно укажите, что нужно расположить модуль в директории, которая находится в папке modules. Иначе ваш модуль будет создан в другом месте.
