Skip to content

Latest commit

 

History

History
91 lines (83 loc) · 7.19 KB

README.md

File metadata and controls

91 lines (83 loc) · 7.19 KB
Raw

Maven

POM structure

General project information

Раздел содержит название проекта, URL, спонсоров, информацию о лицензии, разработчиках и контрибьюторах, которые внесли вклад.

Build settings

Здесь кастомизируется поведение, объявленное в Super POM. Оно описывает расположения исходных текстов и тестов программы. Также в секции можно размещать объявление и настройки самописных плагинов. Еще можно присоединять цели плагинов (plugin goals) к жизненному циклу сборки (lifecycle).

Build environment

В данном разделе определяются настройки сборки

POM relationships

Зависимости, родитель и модули.

POM

POM inheritance

pom.xml, создаваемый для проекта, по умолчанию является наследником super-POM, предоставляемого Maven. В нем находятся объявления:

  • репозитория Maven Central (repository)
  • репозитория плагинов (pluginRepository)
  • директорий исходных кодов, тестов, и т.д. (sourceDirectory, testSourceDirectory, outputDirectory, etc.)
  • версии плагинов (pluginManagement)
  • плагинов, привязанных к фазам сборки (plugins)

Super POM

POM, включающий в себя текущий, всех родителей и корневой, можно увидеть командой mvn help:effective-pom

Phases

Phase Plugin:goal
process-resources resources:resources
compile compiler:compile
process-test-resources resources:testResources
test-compile compiler:testCompile
test surefire:test
package jar:jar
install install:install
deploy deploy:deploy

Все фазы: validate, initialize, generate-sources, process-sources, generate-resources, process-resources, compile, process-classes, generate-test-sources, process-test-sources, generate-test-resources, process-test-resources, test-compile, process-test-classes, test, prepare-package, package, pre-integration-test, integration-test, post-integration-test, verify, install, deploy, pre-clean, clean, post-clean, pre-site, site, post-site, site-deploy.

Profiles

Команда с профилем: mvn <фаза> -P <профиль>

Dependencies

Dependency scope

  • compile - используется для компиляции и запуска (будет размещена в папке /lib)
  • runtime - используется только для фазы работы приложения (jdbc-driver)
  • provided - используется только для фазы компиляции. Предполагается, что на месте запуска приложения данная библиотека есть (servlet-api)
  • test - используется только для компиляции и выполнения тестов

Dependency management

Это возможность управлять зависимостями самого модуля и транзитивными от него. Для этого служит блок <dependencyManagement>. В нем нужно указать зависимости и, что самое главное, их версии. После данной операции указывать версии данных зависимостей в не нужно и не желательно.

Dependency mediation

Если A->B->D.1.0 и A->C->D.2.0, происходит конфликт. Будет использована та зависимость, которая находится выше по дереву. Если две или более зависимостей находятся на одном уровне, то будет выбрана та, которая объявлена первой.

IntelliJ Dependencies Diagram

Кликом в любом месте pom.xml файла и выбором пункта Diagram -> Show Dependencies [Ctrl+Alt+Shift+U] можно открыть диаграмму зависимостей. На ней красными стрелками обозначен путь к конфликтующим зависимостям, которые не будут использоваться.

Project dependencies

Команда mvn dependency:resolve отображает список всех зависимостей проекта в формате [groupId:artifactId:version:phase]. Команда mvn dependency:tree делает аналогичный список, только в формате дерева.

Exclusion

Для исключения транзитивной зависимости из объявляемой в POM.xml необходимо добавить блок непосредственно внутрь , где указать и (без версии), для исключаемой зависимости.

Optional

Зависимость можно задать, как необязательную. Например: A->B->C, где С - необязательная. Тогда, она попадет в A только в том случае, если явно указать зависимость от C в A. Сделать зависимость необязательной можно, указав <optional>true</optional> внутри зависимости. Данный вид зависимости не рекомендуется ввиду того, что он может быть разделен на несколько модулей с выигрышем в очевидности.

Plugins

Плагин включает в себя цели. (Plugin includes goals)

Exec maven plugin

exec-maven-plugin: позволяет выполнить программу (внешнюю или jar), сконфигурировав настройки в POM.xml.

  • mainClass

Other

Tests

Скомпилировать тесты и положить в test-out, но не запускать: -DskipTests. Пропустить тесты полностью: -Dmaven.test.skip=true

Tips and trucks

В многомодульном проекте groupId и version для вложенных модулей лучше задавать через имена родительского проекта: ${groupId} и ${version}

Через запись ${project.*} можно обратиться ко всем свойствам текущего проекта, где * - имя свойства.

Если Maven обращается к удаленному репозиторию, вместо использования локальных библиотек, нужно в папке с библиотекой удалить файл _remote.repositories