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 |