Начало работы с iJaNet SDK¶
Автор: Антон Сержантов
Компания: Janet systems
iJaNet SDK представляет собой набор библиотек (.jar файлов), позволяющих создавать iJaNet модули с поддержкой транспорта, декларирования служб модулей, ссылок на удаленные службы других модулей и других возможностей платформы iJaNet Framework, с которыми более детально вы можно ознакомиться здесь.
iJaNet SDK, как и иные продукты компании JaNet systems LLC, написанные на языке Java, поддерживает механизм "репозиториев" и "артифактов" системы управления и сборки проектов Maven. Компания JaNet systems LLC предоставляет свой репозиторий iJaNet Maven-артифактов стабильных версий. Вы также можете использовать в своих проектах самые последние сборки библиотек платформы iJaNet Framework, ссылаясь на репозиторий iJaNEt Maven-артифактов нестабильных версий.
iJaNet SDK реализован как Maven-архитип. Данный архитип может быть вызван из командной строки. После его исполнения на дисковом пространстве создаться шаблон iJaNet модуля с готовым maven-скриптом для сборки и развертывания модуля в репозитории JaNet Systems LLC.
Для того, чтобы выполнить iJaNet SDK Maven "архитип", необходимо выполнить следующие шаги:
1. Загрузите и установите maven¶
- Загрузите последнюю версию Maven с официального сайта.
- Разархивируйте дистрибутив в любой каталог.
- Добавьте путь InstallationDirectory/bin в переменную окружения операционной среды Windows PATH.
Чтобы проверить правильность установки, наберите в командной строке mvn -version. В окне командной строки должна появиться информации о Maven: его версия и т.д.
2. Вызовите maven-плагин archetype с задачей generate¶
2.1. Для использования последней стабильной версии iJaNet Module Archetype выполните следующую команду
mvn archetype:generate -DarchetypeCatalog=http://repo.ijanet.org/libs-release-local
При этом в ваш локальный maven-репозиторий будут скачены библиотеки iJaNet SDK версии, соответствующей последней стабильной версии iJaNet Module Archetype.
2.2. Для использования нестабильной версии iJaNet Module Archetype выполните следующую команду
mvn archetype:generate -DarchetypeGroupId=org.ijanet -DarchetypeArtifactId=janet-module-archetype -DarchetypeRepository=http://repo.ijanet.org/libs-snapshot-local -DarchetypeVersion=X.Y-SNAPSHOT
где X.Y-SNAPSHOT - желаемая нестабильная версия, например, 5.3-SNAPSHOT
При этом в ваш локальный maven-репозиторий будут скачены библиотеки iJaNet SDK версии, соответствующей указанной нестабильной версии iJaNet Module Archetype.
Структура шаблона iJaNet Module¶
После того, как выполнился iJaNet Module Archetype, на дисковом пространстве создастся папка с именем модуля, содержащая набор папок, показанных на изображении:
Рассмотрим назначение папок и файлов:
- pom.xml - сборочный maven-скрипт для разрабатываемого модуля
- src - директория для исходного java-кода разрабатываемого модуля.
- resources - директория для ресурсов модуля. Все ресурсы кроме файла janet-module.xml в данной папке будут помещены в .jar файл модуля при сборке.
- resources/janet-module.xml - конфигурационный файл iJaNet модуля. Содержит декларацию служб модуля, ссылок на удаленные модули и другие настройки.
- jar - директория содержащая скрипт-файл pom.xml для сборки .jar файла iJaNet модуля
- ear - директория содержащая скрипт-файл pom.xml для сборки .ear файла iJaNet модуля
Для того, чтобы посмотреть, как работает сборочный скрипт для созданного iJaNet модуля, вам необходимо открыть директорию модуля в командной строке Windows и выполнить команду
mvn
После чего в директориях ear/target и jar/target появятся соответствующие maven-артифакты iJaNet модуля.
На этом процесс подготовки шаблона для iJaNet модуля закончен. Вы может приступать к разработке логики модуля. После чего необходимо ввести соответствующую конфигурацию в файл resources/janet-module.xml и собрать модуль при помощи maven.
