maven学习笔记（从入门到实战）

最新推荐文章于 2024-07-14 11:11:21 发布

叶梦_

最新推荐文章于 2024-07-14 11:11:21 发布

阅读量925

点赞数

分类专栏：项目管理工具文章标签： spring boot maven

本文链接：https://blog.csdn.net/qq_15092079/article/details/81950216

版权

项目管理工具专栏收录该内容

1 篇文章 0 订阅

订阅专栏

前言

Maven项目对象模型（POM，Project Object Model的简称），可以通过一小段描述信息来管理项目的构建，报告和文档的软件项目管理工具。只要是通过maven来管理的项目，都可以上传到相应的maven服务器上，让其他项目调用或者依赖。说到被其他项目调用和依赖，这里就要了解下pom.xml文件了，这是maven管理项目的每个项目的核心文件。

这里举个例子，若我们自己通过maven创建了一个项目，并该项目依赖于其他的jar包，这时我们就不需要再像以前那样将每一个jar包都导入到项目中了，只需要在pom.xml文件中配置好相应依赖的jar包，maven会自动到本地仓库或远程仓库去找。

1 安装环境

这里的安装环境只说linux系统和windows系统：

（1）linux系统（debian、centos等），本文以centos 7为例；

（2）windows系统（windows 7、windows 8、windows 10等），本文以windows 10为例。

2 下载安装

下载安装的方式，其实在网上也可以随便找得到，不外乎就两种方式，第一种是比较方便的命令行下载安装，而另外一种原始安装方法，也是最通用的安装方法，先到官网http://maven.apache.org/download.cgi下载压缩包，然后解压出来，最后配置下环境变量就ok了。

注意，不同的操作系统，命令行下载安装的命令可能会有些不同，例如，debian系统默认是以apt-get命令下载安装，而centos则默认是以yum命令下载安装的。

闲话不多说，本文以第二种最通用的方法来安装，先到官网下载压缩包 apache-maven-3.5.4-bin.tar.gz 。

2.1 windows 10的maven安装

（1）解压压缩包 apache-maven-3.5.4-bin.tar.gz 到相应的目录。

（2）配置环境变量。

新建系统变量，这里我因为已经新建了，所以就只给出新建的变量名和变量值了，其实就是maven的解压目录。

编辑系统变量的path变量，添加一行“%MAVEN_HOME%\bin”，若不是win10系统还需要以;与前面分隔，然后点击确定保存就ok啦。

（3）至此，windows10的maven安装已经完成，下面来通过cmd来测试一下。

mvn -v

（4）测试安装成功，用的maven是3.5.4版本，依赖的jdk是1.8。这里顺便提一下，在安装maven之前，需要先安装jdk。

2.2 centos 7的maven安装

（1）上传压缩包 apache-maven-3.5.4-bin.tar.gz 到系统

#创建maven目录
mkdir /usr/maven

#上传maven压缩包
rz

（2）解压压缩包

tar -xzvf apache-maven-3.5.4-bin.tar.gz

（3）配置环境变量

#编辑profile文件
vim /etc/profile

#按shift+g到最后一行，添加以下内容
export MAVEN_HOME=/usr/maven/apache-maven-3.5.4
export PATH=$MAVEN_HOME/bin:$PATH

#保存退出后
#令配置的环境变量生效
source /etc/profile

（4）至此，centos7的maven安装已经完成，来测试一下。

mvn -v

（5）测试安装成功，用的maven是3.5.4版本，依赖的jdk是1.8。这里顺便提一下，在安装maven之前，需要先安装jdk。

3 maven的基本命令

help:active-profiles    列出当前构建中活动的Profile（项目的，用户的，全局的）。
help:effective-pom      显示当前构建的实际POM，包含活动的Profile。
help:effective-settings 打印出项目的实际settings, 包括从全局的settings和用户级别settings继承的配置。
help:describe           描述插件的属性。它不需要在项目目录下运行。但是你必须提供你想要描述插件的 groupId 和 artifactId。

例如：
mvn help:effective-settings
查看实际的maven settings配置，可以查看其jar包的所在目录，默认是“${user.home}/.m2/repository”

4 创建第一个项目

可以到spring官网 https://start.spring.io/ ，自己生成一个以maven为基础的spring boot项目。

生成后的压缩包bootstart.zip中，主要有几个文件是比较重要的，BootstartApplication.java、application.properties和pom.xml。目录如下所示：

BootstartApplication.java文件是程序运行的主文件，代码如下：

package com.sky.bootstart;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class BootstartApplication {

   public static void main(String[] args) {
       SpringApplication.run(BootstartApplication.class, args);
   }
}

application.properties是项目配置的配置文件，若没有啥可配置的话，一般是个空文件。

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.sky</groupId>
   <artifactId>bootstart</artifactId>
   <version>0.0.1-SNAPSHOT</version>
   <packaging>war</packaging>

   <name>bootstart</name>
   <description>Demo project for Spring Boot</description>

   <parent>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-parent</artifactId>
       <version>2.0.4.RELEASE</version>
       <relativePath/> 
   </parent>

   <properties>
       <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
       <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
       <java.version>1.8</java.version>
   </properties>

   <dependencies>
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-web</artifactId>
       </dependency>

       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-tomcat</artifactId>
           <scope>provided</scope>
       </dependency>
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-test</artifactId>
           <scope>test</scope>
       </dependency>
   </dependencies>

   <build>
       <plugins>
           <plugin>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-maven-plugin</artifactId>
           </plugin>
       </plugins>
   </build>

</project>

接下来就是让程序跑起来了，直接运行BootstartApplication.java即可。

5 项目中的pom.xml

首先来看下面的例子spring-cloud测试项目所用到的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.chry</groupId>
<artifactId>springcloud.helloworld.eureka.server</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>
<name>springcloud.helloworld.Eureka.server</name>
<description>Demo Spring Eureka Server</description>

<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.3.RELEASE</version>
<relativePath/> 
</parent>

<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties>

<dependencies>

<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-eureka</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-eureka-server</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-config</artifactId>
</dependency>

<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>

<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>Dalston.RC1</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>

<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>

<repositories>
<repository>
<id>spring-milestones</id>
<name>Spring Milestones</name>
<url>https://repo.spring.io/milestone</url>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>

</project>

5.1 声明规范

<projectxmlns="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.0http://maven.apache.org/maven-v4_0_0.xsd">


<modelVersion>4.0.0</modelVersion>

5.2 基本内容

5.2.1 parent

<parent>


<artifactId/>


<groupId/>


<version/>


<relativePath/>

</parent>

5.2.2 groupId

<!- groupId在一个组织或项目中通常是特有的。例如：(大概、也许)Maven所有artifacts的groupId都使用org.apache.maven。groupId并不一定必须使用点符号，例如，JUnit项目。注意使用点符号的groupId不必与项目的包结构相同，但它是一个很好的做法。 -->
<groupId>org.codehaus.mojo</groupId>

5.2.3 artifactId

<artifactId>my-project</artifactId>

5.2.4 version

<version>1.0-SNAPSHOT</version>

5.2.5 packaging

<packaging>jar</packaging>

5.2.6 dependencies

<dependencies>

<dependency>


<groupId>org.apache.maven</groupId>


<artifactId>maven-artifact</artifactId>


<version>3.8.1</version>


<type>jar</type>


<classifier></classifier>


<scope>test</scope>


<systemPath></systemPath>


<optional>true</optional>


<exclusions>

<exclusion>

<artifactId>spring-core</artifactId>

<groupId>org.springframework</groupId>

</exclusion>

</exclusions>


<optional>true</optional>

</dependency>

</dependencies>

5.2.7 dependencyManagement

<dependencyManagement>


<dependencies>
<dependency>
......
</dependency>
</dependencies>

</dependencyManagement>

5.2.8 modules

<modules/>

5.2.9 properties

<properties>
<dept>No</dept>
</properties>

5.3 编译设置

5.3.1 build

<build>


<defaultGoal>install</defaultGoal>


<directory>${basedir}/target</directory>


<finalName>${artifactId}-${version}</finalName>


<filters>
<filter>src/main/filters/filter.properties</filter>
</filters>


<resources>

<resource>


<targetPath></targetPath>


<filtering>false</filtering>


<directory>${basedir}/src/main/resources </directory>


<includes>
<include>configuration.xml</include>
</includes>


<excludes>
<exclude>**/*.properties</exclude>
</excludes>

</resource>
</resources>


<testResources>
<testResource>
<targetPath/>
<filtering/>
<directory/>
<includes/>
<excludes/>
</testResource>
</testResources>

<plugins>

<plugin>


<groupId>org.apache.maven.plugins</groupId>


<artifactId>maven-jar-plugin</artifactId>


<version>2.0</version>


<extensions>false</extensions>


<inherited>true</inherited>


<configuration>
<classifier>test</classifier>
</configuration>


<dependencies>
<dependency>
<groupId/>
<artifactId/>
<version/>
<type/>
<classifier/>
<scope/>
<systemPath/>
<exclusions>
<exclusion>
<artifactId/>
<groupId/>
</exclusion>
</exclusions>
<optional/>
</dependency>
</dependencies>


<executions>

<execution>


<id>echodir</id>


<phase>verify</phase>


<goals>
<goal>run</goal>
</goals>


<inherited>false</inherited>


<configuration>
<tasks>
<echo>Build Dir: ${project.build.directory}</echo>
</tasks>
</configuration>
</execution>
</executions>
</plugin>
</plugins>


<pluginManagement>
<plugins>
.................
</plugins>
</pluginManagement>


<sourceDirectory>${basedir}/src/main/java</sourceDirectory>


<scriptSourceDirectory>${basedir}/src/main/scripts</scriptSourceDirectory>


<testSourceDirectory>${basedir}/src/test/java</testSourceDirectory>


<outputDirectory>${basedir}/target/classes</outputDirectory>


<testOutputDirectory>${basedir}/target/test-classes</testOutputDirectory>


<extensions>

<extension>

<groupId/>


<artifactId/>


<version/>
</extension>
</extensions>

</build>

5.3.2 reporting

<reporting>


<outputDirectory>${basedir}/target/site</outputDirectory>


<excludeDefaults>false</excludeDefaults>


<plugins>

<plugin>


<groupId>org.apache.maven.plugins</groupId>


<artifactId>maven-project-info-reports-plugin</artifactId>


<version>2.7</version>


<inherited>true<inherited/>


<configuration/>


<reportSets>

<reportSet>


<id>default<id>


<configuration/>


<inherited/>


<reports/>

</reportSet>
</reportSets>
</plugin>
</plugins>
</reporting>

5.4 项目信息

5.4.1 name

<name>banseon-maven</name>

5.4.2 description

<description>Amavenprojecttostudymaven.</description>

5.4.3 url

<url>http://www.baidu.com/banseon</url>

5.4.4 inceptionYear

<inceptionYear/>

5.4.5 licenses

<licenses>

<license>


<name>Apache2</name>


<url>http://www.baidu.com/banseon/LICENSE-2.0.txt</url>


<distribution>repo</distribution>


<comments>Abusiness-friendlyOSSlicense</comments>

</license>
</licenses>

5.4.6 organization

<organization>


<name>demo</name>


<url>http://www.baidu.com/banseon</url>

</organization>

5.4.7 developers

<developers>


<developer>


<id>HELLOWORLD</id>


<name>banseon</name>


<email>banseon@126.com</email>


<url/>


<roles>
<role>ProjectManager</role>
<role>Architect</role>
</roles>


<organization>demo</organization>


<organizationUrl>http://hi.baidu.com/banseon</organizationUrl>


<timezone>-5</timezone>


<properties>
<picUrl>http://tinyurl.com/prv4t</picUrl>
</properties>

</developer>

</developers>

5.4.8 contributors

<contributors>

<contributor>
<name/>
<email/>
<url/>
<organization/>
<organizationUrl/>
<roles/>
<timezone/>
<properties/>
</contributor>
</contributors>

5.5 环境设置

5.5.1 issueManagement

<issueManagement>

<system>jira</system>


<url>http://jira.baidu.com/banseon</url>
</issueManagement>

5.5.2 ciManagement

<ciManagement>


<system>continuum</system>


<url>http://127.0.0.1:8080/continuum</url>


<notifiers>

<notifier>


<type>mail</type>


<sendOnError>true</sendOnError>


<sendOnFailure>true</sendOnFailure>


<sendOnSuccess>false</sendOnSuccess>


<sendOnWarning>false</sendOnWarning>


<address/>


<configuration><address>continuum@127.0.0.1</address></configuration>

</notifier>
</notifiers>
</ciManagement>

5.5.3 mailingLists

<mailingLists>

<mailingList>


<name>User List</name>


<post>user@127.0.0.1</post>


<subscribe>user-subscribe@127.0.0.1</subscribe>


<unsubscribe>user-unsubscribe@127.0.0.1</unsubscribe>


<archive>http://127.0.0.1/user/</archive>


<otherArchives>

<otherArchive>http://base.google.com/base/1/127.0.0.1</otherArchive>

</mailingList>
</mailingLists>

5.5.4 scm

<scm>

<connection>scm:svn:http://127.0.0.1/svn/my-project</connection>


<developerConnection>scm:svn:https://127.0.0.1/svn/my-project</developerConnection>


<tag>HEAD</tag>


<url>http://127.0.0.1/websvn/my-project</url>
</scm>

5.5.5 prerequisites

<prerequisites>

<maven>2.0.6</maven>
</prerequisites>

5.5.6 repositories

<repositories>

<repository>


<id>codehausSnapshots</id>


<name>Codehaus Snapshots</name>


<releases>

<enabled>false</enabled>


<updatePolicy>always</updatePolicy>


<checksumPolicy>warn</checksumPolicy>

</releases>


<snapshots>
<enabled/><updatePolicy/><checksumPolicy/>
</snapshots>


<url>http://snapshots.maven.codehaus.org/maven2</url>


<layout>default</layout>

</repository>
</repositories>

5.5.7 pluginRepositories

<pluginRepositories>
<pluginRepository>
<releases>
<enabled/>
<updatePolicy/>
<checksumPolicy/>
</releases>

<snapshots>
<enabled/>
<updatePolicy/>
<checksumPolicy/>
</snapshots>

<id/>

<name/>

<url/>

<layout/>

</pluginRepository>
</pluginRepositories>

5.5.8 distributionManagement

<distributionManagement>

<repository>

<uniqueVersion>true</uniqueVersion>
<id/>
<name/>
<url/>
<layout/>

<releases>
<enabled/>
<updatePolicy/>
<checksumPolicy/>
</releases>

<snapshots>
<enabled/>
<updatePolicy/>
<checksumPolicy/>
</snapshots>

</repository>


<snapshotRepository>
<uniqueVersion>true</uniqueVersion>
<id/>
<name/>
<url/>
<layout/>

<releases>
<enabled/>
<updatePolicy/>
<checksumPolicy/>
</releases>

<snapshots>
<enabled/>
<updatePolicy/>
<checksumPolicy/>
</snapshots>
</snapshotRepository>


<site>

<id>banseon-site</id>


<name>businessapiwebsite</name>


<url>scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web</url>
</site>


<downloadUrl/>


<relocation>


<groupId/>


<artifactId/>


<version/>


<message/>

</relocation>


<status/>

</distributionManagement>

5.5.9 profiles

<profiles>

<profile>


<id>test</id>


<activation>

<activeByDefault>false</activeByDefault>


<jdk>1.5</jdk>


<os>

<name>Windows XP</name>


<family>Windows</family>


<arch>x86</arch>


<version>5.1.2600</version>
</os>


<property>

<name>mavenVersion</name>


<value>2.0.3</value>
</property>


<file>

<exists>${basedir}/file2.properties</exists>


<missing>${basedir}/file1.properties</missing>
</file>

</activation>


<build>
<defaultGoal/>

<resources>
<resource>
<targetPath/><filtering/><directory/><includes/><excludes/>
</resource>
</resources>

<testResources>
<testResource>
<targetPath/><filtering/><directory/><includes/><excludes/>
</testResource>
</testResources>

<directory/><finalName/><filters/>

<pluginManagement>
<plugins>

<plugin>

<groupId/><artifactId/><version/><extensions/>

<executions>
<execution>
<id/><phase/><goals/><inherited/><configuration/>
</execution>
</executions>

<dependencies>

<dependency>
......
</dependency>
</dependencies>

<goals/><inherited/><configuration/>

</plugin>
</plugins>
</pluginManagement>

<plugins>

<plugin>
<groupId/><artifactId/><version/><extensions/>

<executions>
<execution>
<id/><phase/><goals/><inherited/><configuration/>
</execution>
</executions>

<dependencies>

<dependency>
......
</dependency>
</dependencies>

<goals/><inherited/><configuration/>
</plugin>
</plugins>
</build>


<repositories>

<repository>
<releases>
<enabled/><updatePolicy/><checksumPolicy/>
</releases>

<snapshots>
<enabled/><updatePolicy/><checksumPolicy/>
</snapshots>

<id/><name/><url/><layout/>
</repository>
</repositories>


<dependencies>

<dependency>
......
</dependency>
</dependencies>


<reports/>


<distributionManagement>
......
</distributionManagement>


<properties/>

</profile>
</profiles>

6 maven的setting.xml

maven项目的setting.xml文件主要分有两个：maven安装和用户安装。

maven安装：${maven.home}/conf/settings.xml
用户安装：${user.home}/.m2/settings.xml

maven安装也被称为全局setting，而用户安装则被称为用户setting。若两个文件同时存在的话，会将他们合并，并且以用户安装为主。

以下时setting.xml文件顶级元素的概述：

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd">
<localRepository/>
<interactiveMode/>
<offline/>
<pluginGroups/>
<servers/>
<mirrors/>
<proxies/>
<profiles/>
<activeProfiles/>
</settings>

6.1 localRepository

自定义本地库路径，默认在 ${user.home}/.m2中。

6.2 interactiveMode

交互模式，Maven是否应该尝试与用户输入交互，默认是true，如果不是false。

6.3 offline

是否每次编译都去查找远程中心库，如果此构建系统应以离线模式运行，则为true，默认为false。由于网络设置或安全原因，此元素对于构建无法连接到远程存储库的服务器非常有用。

6.4 pluginGroups

该元素包含一个pluginGroup元素列表，每个元素都包含一个groupId，使用插件时搜索列表，虽然命令行中未提供groupId，但此列表自动包含org.apache.maven.plugins和org.codehaus.mojo。

<settings xmlns =“http://maven.apache.org/SETTINGS/1.0.0”
xmlns：xsi =“http://www.w3.org/2001/XMLSchema-instance”
xsi：schemaLocation =“http：/ /maven.apache.org/SETTINGS/1.0.0
https://maven.apache.org/xsd/settings-1.0.0.xsd“>
...
<pluginGroups>
<pluginGroup> org.eclipse.jetty </ pluginGroup >
</ pluginGroups>
...
</ settings>

例如，给定上述设置，Maven命令行是使用 org.eclipse.jetty:jetty-maven-plugin:run 运行，也可以使用truncated命令执行：mvn jetty:run

6.5 mirrors

镜像库，可以指定内部中心库。

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
https://maven.apache.org/xsd/settings-1.0.0.xsd">
...
<mirrors>
<mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>
...
</settings>

id，name：镜像的唯一标识符和用户的名字。该id用于区分镜像元素，并在连接镜像时从部分选择相应的凭据。
url：镜像的基本URL。构建系统将使用此URL来连接到存储库，而不是原始存储库URL。
mirrorOf：这是一个镜像的存储库的ID。
例如，要指向Maven 中央存储库（https://repo.maven.apache.org/maven2/）的镜像，设置为central。也可以设置为repo1，repo2或*，！inhouse。

叶梦_

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
maven学习笔记（从入门到实战）

前言Maven项目对象模型（POM，Project Object Model的简称），可以通过一小段描述信息来管理项目的构建，报告和文档的软件项目管理工具。只要是通过maven来管理的项目，都可以上传到相应的maven服务器上，让其他项目调用或者依赖。说到被其他项目调用和依赖，这里就要了解下pom.xml文件了，这是maven管理项目的每个项目的核心文件。这里举个例子，若我们自己通过mav...
复制链接

扫一扫