Предполагая, что у нас есть проект с именем project и модули module1 и module2, ранее я использовал следующую стратегию именования:
-- project
-- projectModule1
-- projectModule2
Сейчас использую другой:
-- project
-- project-module1
-- project-module2
Каковы наилучшие методы именования модулей Maven?
Я сделал несколько заметок по этому поводу в книге «Эффективная реализация», но там нет правил или канонических соглашений.
Подведем некоторые итоги:
Прежде всего, самое главное, чтобы вы были последовательны.
Общее соглашение Maven использует «-» в качестве разделителя (commons-lang, maven-model).
Если вы собираетесь использовать его извне, помните module = artifact ID = filename (наилучшая практика), поэтому он должен быть узнаваемым (maven-model-2.0.jar понятно, model-2.0.jar нет). В этом случае вы обычно повторяете последний элемент идентификатора группы как мини-пространство имен. Для краткости «внутренние» модули могут опустить его (как показано в примере приложения: http://github.com/brettporter/centrepoint/tree/master/centrepoint/modules/).
Кроме того, я бы сделал их как можно короче.
Вы можете провести параллель между соглашениями об именах пакетов и классов Java с идентификаторами групп и артефактов Maven.
Обычно я стараюсь, чтобы имена модулей были краткими. Если имя «хочет» быть длинным, это указывает на то, что другой уровень вложенности, вероятно, является хорошей идеей. Итак, вместо этого:
- root
- api
- impl
- security
- service-soap
- service-rest
- client-swing
- client-web-html
- client-web-mobile
Я бы вложил вещи дальше:
- root
- api
- impl
- security
- service
- soap
- rest
- client
- swing
- web
- html
- mobile
с помощью параметров реактора maven вы все равно можете создавать вложенные модули, изолированные сверху:
mvn -pl client/web clean install
Вы даже можете пойти еще дальше:
-- project
-- project-module-1
-- project-module-2
Без шуток, это действительно вопрос вкуса.
Добрый день Максим
