Как интегрировать коммерческие сторонние артефакты в ваш Maven Build

Согласно недавнему опросу RebelLabs компании ZeroTurnaround , Maven по-прежнему является ведущей платформой сборки Java. По данным RebelLabs, текущая доля рынка:

• Maven с 64%
• Муравей + Плющ с 16,5%
• Gradle с 11%

Тем не менее, в то же время, Maven часто критикуют за то, что он немного неясен и навязчив. По сравнению с призерами Ant и Gradle, Maven допускает лишь небольшую гибкость в отношении интерпретации и, следовательно, индивидуальной адаптации модели сборки. Или, как сказал бы Тим Берглунд из Data Stax:

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

Интеграция сторонних коммерческих артефактов

Не все сторонние артефакты, от которых вы хотели бы зависеть, доступны бесплатно в Maven Central. Примерами этого являются коммерческие драйверы JDBC или коммерческие выпуски jOOQ . Существуют три способа интеграции таких артефактов в вашу сборку:

Быстро и грязно

Часто вам нужна коммерческая зависимость только для небольшого тестового проекта или демонстрации. Вы хотите быть уверены, что он работает, когда вы запускаете его, независимо от настроек вашего локального репозитория или сетевого подключения. Это хороший пример использования для <scope>system</scope> :

Например: JOOQ

Например: Microsoft SQL JDBC

Преимущества этого подхода

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

Недостатки этого подхода

Системные зависимости никогда не переходят по наследству. Если ваш модуль зависит от jOOQ таким образом, зависимости вашего модуля не будут видеть API jOOQ.

Подробности о системных зависимостях можно увидеть в документации Maven . Ссылаясь на документацию:

Зависимости с системой областей видимости всегда доступны и не ищутся в репозитории. Они обычно используются, чтобы сообщить Maven о зависимостях, предоставляемых JDK или виртуальной машиной. Таким образом, системные зависимости особенно полезны для разрешения зависимостей от артефактов, которые теперь предоставляются JDK, но где они доступны как отдельные загрузки ранее. Типичным примером являются стандартные расширения JDBC или Служба аутентификации и авторизации Java (JAAS).

Немного более надежный

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

Пакет Windows

Linux Shell

Приведенные выше сценарии по существу проверяют, доступны ли какие-либо из Javadoc, Sources и / или двоичных файлов в дистрибутиве, а затем устанавливают:

• Родитель pom.xml
• Различные двоичные файлы артефактов, исходные коды, файлы javadocs и pom.xml

Преимущества этого подхода

На зависимости теперь можно ссылаться, как на любые другие типы зависимостей, так как артефакты зарегистрированы в вашем локальном хранилище. Более того, они также доступны для собственных зависимостей вашего модуля, транзитивно — что, вероятно, то, что вы хотите, когда вы используете jOOQ. Вот как вы могли бы указать зависимости:

Недостатки этого подхода

В установке зависимостей есть ручной шаг. Если у вас нет доступных сценариев выше, может быть довольно утомительно выяснить, как шаг за шагом импортировать все эти зависимости в ваш репозиторий. В частности, если вы используете демонстрационную версию или прототип, это может привести к неожиданной ошибке компиляции в худшие моменты.

Путь

Очевидно, что при реальной настройке проекта ни один из вышеперечисленных подходов не будет достаточным, и вы, вероятно, импортируете библиотеки в свой локальный Nexus или Bintray или в любой используемый вами репозиторий. Просто остерегайтесь потенциальных ограничений на распространение, которые могут иметь коммерческие результаты.

Небольшое руководство по установке артефактов в Nexus можно найти здесь .