{"draftJsState":{"blocks":[{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":22,"offset":0,"style":"BOLD"}],"text":"1. Проблема и варианты","type":"header-two","key":"u6oj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":137,"style":"BOLD"}],"text":"Maven — очень универсальный инструмент, и его общедоступные репозитории не имеют себе равных. Однако всегда будет артефакт, который либо нигде не размещен , либо зависит от репозитория, в котором он размещен, рискованно, поскольку он может не работать, когда он вам нужен.","type":"unstyled","key":"cqgnf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Когда это происходит, есть несколько вариантов:","type":"unstyled","key":"anmqv"},{"data":{},"depth":0,"entityRanges":[{"key":0,"length":15,"offset":77}],"inlineStyleRanges":[{"length":26,"offset":51,"style":"BOLD"}],"text":"стисните зубы и установите полноценное решение для управления репозиторием , такое как Nexus","type":"unordered-list-item","key":"naio"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"попытайтесь загрузить артефакт в один из более авторитетных публичных репозиториев","type":"unordered-list-item","key":"2661l"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":8,"offset":20,"style":"BOLD"}],"text":"установить артефакт локально с помощью плагина maven","type":"unordered-list-item","key":"d2ih5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"},{"length":13,"offset":44,"style":"BOLD"}],"text":"Nexus , конечно, более зрелое решение, но и более сложное . Предоставление экземпляра для запуска Nexus, настройка самого Nexus, его настройка и обслуживание могут быть излишними для такой простой проблемы, как использование одного jar-файла. Однако, если этот сценарий — размещение пользовательских артефактов — является распространенным, менеджер репозитория имеет большой смысл.","type":"unstyled","key":"75jf9"},{"data":{},"depth":0,"entityRanges":[{"key":1,"length":10,"offset":126}],"inlineStyleRanges":[{"length":25,"offset":21,"style":"BOLD"}],"text":"Загрузка артефакта в общедоступный репозиторий или непосредственно в Maven Central также является хорошим решением, но обычно длительным . Кроме того, библиотека может вообще не поддерживать Maven, что значительно усложняет процесс, поэтому использование артефакта СЕЙЧАС не является реалистичным решением.","type":"unstyled","key":"5hpfn"},{"data":{},"depth":0,"entityRanges":[{"key":2,"length":20,"offset":132}],"inlineStyleRanges":[{"length":67,"offset":157,"style":"BOLD"}],"text":"Остается третий вариант — добавление артефакта в систему управления версиями и использование плагина maven — в данном случае плагин maven-install-plugin для его локальной установки до того, как он понадобится процессу сборки . Это, безусловно, самый простой и надежный вариант.","type":"unstyled","key":"sir2"},{"data":{"image":{"id":"65b7864f3224a05976801cd0"},"images":[{"id":"65b7864f3224a05976801cd0"}],"contents":{}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"f34cu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":70,"offset":0,"style":"BOLD"},{"length":30,"offset":40,"style":"ITALIC"}],"text":"2. Установите локальную банку с помощью плагина maven-install-plugin .","type":"header-two","key":"aph6d"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Начнем с полной настройки, необходимой для установки артефакта в наш локальный репозиторий:","type":"unstyled","key":"77c2g"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"ck1ih"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" org.apache.maven.plugins","type":"blockquote","key":"35ae8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" maven-install-plugin","type":"blockquote","key":"6nfpi"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" 2.5.1","type":"blockquote","key":"2eagc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" ","type":"blockquote","key":"88j6h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" org.somegroup","type":"blockquote","key":"ah6fq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" someartifact","type":"blockquote","key":"65poc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" 1.0","type":"blockquote","key":"839mu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" jar","type":"blockquote","key":"4rp82"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" ${basedir}/dependencies/someartifact-1.0.jar","type":"blockquote","key":"7u6p5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" true","type":"blockquote","key":"7pqr0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" ","type":"blockquote","key":"32lqm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" ","type":"blockquote","key":"7dors"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" ","type":"blockquote","key":"e5mrd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" install-jar-lib","type":"blockquote","key":"b42ho"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" ","type":"blockquote","key":"c15nd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" install-file","type":"blockquote","key":"6b2e6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" ","type":"blockquote","key":"2nt4t"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" validate","type":"blockquote","key":"3edr0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" ","type":"blockquote","key":"89ro7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" ","type":"blockquote","key":"1i2dl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"6pdmh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь давайте разберем и проанализируем детали этой конфигурации.","type":"unstyled","key":"7k2bb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":28,"offset":0,"style":"BOLD"}],"text":"2.1. Информация об артефакте","type":"header-three","key":"6eohn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":15,"offset":56,"style":"ITALIC"},{"length":16,"offset":136,"style":"ITALIC"},{"length":8,"offset":155,"style":"ITALIC"},{"length":7,"offset":166,"style":"ITALIC"}],"text":"Информация об артефакте определяется как часть элемента . Фактический синтаксис очень похож на объявление зависимости — элементы groupId , ArtiftId и version .","type":"unstyled","key":"65rsm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":8,"offset":49,"style":"ITALIC"},{"length":3,"offset":90,"style":"ITALIC"}],"text":"Следующая часть конфигурации требует определения упаковки артефакта — она указывается как jar .","type":"unstyled","key":"d9u93"},{"data":{},"depth":0,"entityRanges":[{"key":3,"length":8,"offset":146}],"inlineStyleRanges":[{"length":14,"offset":24,"style":"BOLD"},{"length":28,"offset":146,"style":"BOLD"},{"length":10,"offset":200,"style":"ITALIC"},{"length":7,"offset":281,"style":"ITALIC"},{"length":20,"offset":314,"style":"ITALIC"},{"length":14,"offset":366,"style":"ITALIC"}],"text":"Затем нам нужно указать местоположение фактического файла jar для установки — это может быть абсолютный путь к файлу или относительный, используя свойства , доступные в Maven . В этом случае свойство ${basedir} представляет собой корень проекта, а именно место, где находится файл pom.xml . Это означает, что файл someartifact-1.0.jar необходимо поместить в каталог /dependencies/ под корнем.","type":"unstyled","key":"e656m"},{"data":{},"depth":0,"entityRanges":[{"key":4,"length":22,"offset":31}],"inlineStyleRanges":[],"text":"Наконец, есть несколько других необязательных деталей , которые также можно настроить.","type":"unstyled","key":"9fe1t"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":15,"offset":0,"style":"BOLD"}],"text":"2.2. Выполнение","type":"header-three","key":"etv6r"},{"data":{},"depth":0,"entityRanges":[{"key":5,"length":23,"offset":68}],"inlineStyleRanges":[{"length":17,"offset":11,"style":"BOLD"},{"length":13,"offset":41,"style":"BOLD"},{"length":12,"offset":16,"style":"ITALIC"},{"length":8,"offset":46,"style":"ITALIC"}],"text":"Выполнение цели install-file привязано к фазе проверки стандартного жизненного цикла сборки Maven . Таким образом, перед попыткой компиляции вам нужно будет явно запустить фазу проверки:","type":"unstyled","key":"948l3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"mvn validate","type":"blockquote","key":"edv2b"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"После этого шага стандартная компиляция будет работать:","type":"unstyled","key":"4aam2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"mvn clean install","type":"blockquote","key":"cer3m"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":25,"offset":44,"style":"ITALIC"}],"text":"Как только фаза компиляции выполняется, наш файл someartifact-1.0.jar корректно устанавливается в наш локальный репозиторий, как и любой другой артефакт, который мог быть получен из центра Maven.","type":"unstyled","key":"8osm0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":33,"offset":0,"style":"BOLD"},{"length":3,"offset":15,"style":"ITALIC"},{"length":3,"offset":30,"style":"ITALIC"}],"text":"2.3. Генерация POM и поставка POM","type":"header-three","key":"e29j6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":7,"offset":46,"style":"ITALIC"},{"length":31,"offset":99,"style":"BOLD"},{"length":16,"offset":278,"style":"BOLD"}],"text":"Вопрос о том, нужно ли нам предоставлять файл pom.xml для артефакта или нет, зависит в основном от зависимостей времени выполнения самого артефакта. Проще говоря, если артефакт имеет зависимости времени выполнения от других jar-файлов, эти jar-файлы также должны присутствовать в пути к классам во время выполнения. С простым артефактом это не должно быть проблемой, поскольку он, скорее всего, не будет иметь зависимостей во время выполнения (лист в графе зависимостей).","type":"unstyled","key":"9vpu5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":9,"style":"ITALIC"},{"length":12,"offset":28,"style":"ITALIC"}],"text":"Параметр generatePom в цели install-file должен быть достаточным для таких артефактов:","type":"unstyled","key":"dl8lh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"true","type":"blockquote","key":"1julm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":57,"style":"BOLD"},{"length":7,"offset":305,"style":"ITALIC"}],"text":"Однако если артефакт более сложный и имеет нетривиальные зависимости , то, если этих зависимостей еще нет в пути к классам, их необходимо добавить. Один из способов сделать это — определить эти новые зависимости вручную в файле pom проекта. Лучшим решением является предоставление пользовательского файла pom.xml вместе с установленным артефактом:","type":"unstyled","key":"qp7b"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"false ${basedir}/dependencies/someartifact-1.0.pom","type":"blockquote","key":"99gdt"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":7,"offset":93,"style":"ITALIC"}],"text":"Это позволит Maven разрешать все зависимости артефакта, определенные в этом пользовательском pom.xml , без необходимости определять их вручную в основном файле pom проекта.","type":"unstyled","key":"c8gmg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"BOLD"}],"text":"3. Заключение","type":"header-two","key":"9k8qd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":20,"offset":128,"style":"ITALIC"}],"text":"В этой статье рассказывается, как использовать jar, который нигде не размещен в проекте Maven, установив его локально с помощью maven-install-plugin .","type":"unstyled","key":"cf26n"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"marker","key":"xEUikB0u3JQ93b3djkWJ"}],"entityMap":{"0":{"data":{"url":"http://www.sonatype.org/nexus/"},"mutability":"MUTABLE","type":"LINK"},"1":{"data":{"url":"https://maven.apache.org/guides/mini/guide-central-repository-upload.html"},"mutability":"MUTABLE","type":"LINK"},"2":{"data":{"url":"https://maven.apache.org/plugins/maven-install-plugin/"},"mutability":"MUTABLE","type":"LINK"},"3":{"data":{"url":"https://cwiki.apache.org/confluence/display/MAVEN/Maven+Properties+Guide"},"mutability":"MUTABLE","type":"LINK"},"4":{"data":{"url":"https://maven.apache.org/plugins/maven-install-plugin/install-file-mojo.html"},"mutability":"MUTABLE","type":"LINK"},"5":{"data":{"url":"https://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html"},"mutability":"MUTABLE","type":"LINK"}}},"mentions":[]}