maven dependencymanagementの使用用途
最近、mavenを学習したときに引っ掛かりを覚えたのでメモ *1
何に引っ掛かりを覚えたか
公式ではなく、他の方の記事から引用になってしまうのですが、、、dependenciesとは違って依存関係の定義ではなく、依存関係の定義の為の定義 *2
私がマルチスタイルのプロジェクトのpomをガッツリ管理したことがないからか、
使用例を見ても利便性を理解できず
腹落ちした理由
intellijでは、dependencyManagementで指定されている依存関係のリストを表示して任意のライブラリを追加することができる
毎回親pomを除いてコピペするが面倒くさいと思っていたけど、これは便利
と書いていて気がついた
ライブラリを追加するときに、毎回親pomを見ることに面倒くささを感じていたんだな
参考
maven3に慣れる - 備忘log *1Mavenでビルドする際の10のTips - cynipeと読む *2
Maven 依存関係 | IntelliJ IDEA ドキュメント *3
maven3に慣れる
はじめに
業務でmavenを利用している、正直、雰囲気で触っている。 苦手意識を克服することを目標に、mavenの学習に取り組もうと思う 公式のDocumentを読んで理解できるタイプではないため、Maven3 チュートリアルに沿って手を動かしながら学習をする
※TECHSCORE(テックスコア)と迷ったが前者のほうが情報が圧倒的に新しいので、そちらを選択
ゴール
java + Spring Bootのプロジェクトを触る上で困らない程度に理解できること
環境
$ mvn -v Apache Maven 3.9.3 (21122926829f1ead511c958d89bd2f672198ae9f) Maven home: C:\Program Files\apache-maven-3.9.3 Java version: 17.0.2, vendor: Oracle Corporation, runtime: C:\Program Files\jdk-17.0.2 Default locale: ja_JP, platform encoding: MS932 OS name: "windows 11", version: "10.0", arch: "amd64", family: "windows"
1章
スケルトン（雛形）を作成
出来上がったものがこちら
$ cat .\pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>hello</artifactId>
<version>1.0-SNAPSHOT</version>
<name>hello</name>
<!-- FIXME change it to the project's website -->
<url>http://www.example.com</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>1.7</maven.compiler.source>
<maven.compiler.target>1.7</maven.compiler.target>
</properties>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
<plugins>
<!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
<plugin>
<artifactId>maven-clean-plugin</artifactId>
<version>3.1.0</version>
</plugin>
<!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
<plugin>
<artifactId>maven-resources-plugin</artifactId>
<version>3.0.2</version>
</plugin>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.0</version>
</plugin>
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.22.1</version>
</plugin>
<plugin>
<artifactId>maven-jar-plugin</artifactId>
<version>3.0.2</version>
</plugin>
<plugin>
<artifactId>maven-install-plugin</artifactId>
<version>2.5.2</version>
</plugin>
<plugin>
<artifactId>maven-deploy-plugin</artifactId>
<version>2.8.2</version>
</plugin>
<!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
<plugin>
<artifactId>maven-site-plugin</artifactId>
<version>3.7.1</version>
</plugin>
<plugin>
<artifactId>maven-project-info-reports-plugin</artifactId>
<version>3.0.0</version>
</plugin>
</plugins>
</pluginManagement>
</build>
</project>
pomの内容について
スケルトンを作成するときに入力したgroupId,artifactId,version,packageは以下のように反映される
- groupId,artifactId,versionはpom.xmlに反映
<groupId>com.example</groupId> <artifactId>hello</artifactId> <version>1.0-SNAPSHOT</version>
- packageはプロジェクトのパッケージ構成に反映される
src\main\java\com\example
各要素が持つ意味は次の通り *1
| groupId | プロジェクトを一意に識別する名前。 プロジェクトのルートパッケージ名を指定するのが一般的です。 |
| artifactId | プロジェクトの成果物の名前。 作成する JAR や WAR, EAR ファイルなどの名前に使用されます。 |
| version | プロジェクトのバージョン。 snapshotについて：Maven SNAPSHOTの概要とリリース方法（スナップショット） - Web系開発メモ |
1.6.2 TODO テストコンパイル設定
src/main配下はテスト用のコードを配置する場所ではないため、エラーになる
junitのdependencyから<scope>test<scope>の記載を削除してもだめ
1.6.3 TODO リソースの配置
javaフォルダ配下のhoge.txtはコピーされず、resouces配下のhoge.txtはコピーされる これは、1.5.1で出力した設定値を見ると解決する
1.7,1.8は割愛（知っている内容について記載を行うことに疲れてきた）
2章
読み物なので記載を割愛
3章
※3.1,3.2はスキップ
3.3
| ライブラリ | 説明 | 適切なスコープ | そのスコープにした理由 |
|---|---|---|---|
| junit.jar | ユニットテスト用ライブラリ | compile or runtime | どこまでテストを組むのかによるけど、基本的にcompileでよいという理解 |
| ojdbc6.jar | Oracle JDBCドライバ | ||
| slf4j-api.jar | ロギングライブラリ | ||
| servlet-api.jar | Servlet API |
