Maven 基础入门使用

全栈工程师修炼指南

发布于 2022-09-29 15:45:10

1.5K0

发布于 2022-09-29 15:45:10

0x00 基础介绍

Maven 拉取 Jar 的几种途径

                -> 国外 Maven Jar 服务器
Gitlab -> Maven -> 国内 Maven Jar 镜像服务器
                -> 企业 内部 Maven Jar 私服服务器 (可以双向同步)

Maven版本：

version（SNAPSHOT）：快照版本随时更新不稳定的，每个版本都只是特定时间点的快照。同时，SNAPSHOT的不稳定性会带来风险，本地仓库中快照版本的依赖的目录下会看到带有时间戳的jar包。例如：A–>B-1.3.8-SNAPSHOT（理解为A依赖了B的1.3.8-SNAPSHOT版本），那么B-1.3.8-SNAPSHOT更新且重新deploy到仓库之后，A只需要重新构建就可以拿到最新的代码，不用修改依赖B的版本。这样达到了变更传达的透明性。 version（RELEASE)：发布（正式）版本，是稳定的版本号，应该一旦发布永远不变。 version（LATEST）：不稳定版本，不管是快照还是发布版，就是去拉最新的。

注意: 不推荐直接使用<version>RELEASE<version>和 <version>LATEST<version>，因为它们都会在打包时去远程仓库拉取最新的，从而可能导致同一项目在打包时依赖不同的jar包。

#依赖是具体的发布版本x.RELEASE:
在本地仓库中搜索，找到则成功。
在远程仓库中搜索，找到则下载。
如果没有设置远程仓库，Maven 默认去中央仓库搜索，找到则下载。
在一个或多个远程仓库中搜索依赖的文件，如果找到则下载到本地仓库以备将来引用，否则 Maven 将停止处理并抛出错误（无法找到依赖的文件）。

#依赖是快照版本x.SNAPSHOT、RELEASE、LATEST：
基于更新策略更新（updatePolicy= always），则总是尝试去远程仓库拉取最新版本
强制快照更新------mvn clean install-U

maven的三种仓库:

- 1.本地仓库: 安装maven环境后会在本地生成一个`{%username%}/.m2/respository/`仓库位置,可在maven的配置文件`setting.xml`中更改此位置

0x01 环境安装

1.Maven 安装配置

安装包准备: Maven 官网下载地址: https://maven.apache.org/download.cgi

WeiyiGeek.核验下载

安装环境测试:

Java 的 hello-world 项目 Pom.xml

<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.weiyigeek.main</groupId>
  <artifactId>maven</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>jar</packaging>

  <name>hello-world</name>
  <url>http://maven.apache.org</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
  
  <build>  
    <plugins>  
        <plugin>  
            <groupId>org.apache.maven.plugins</groupId>  
            <artifactId>maven-shade-plugin</artifactId>  
            <version>2.4.1</version>  
            <executions>  
                <execution>  
                    <phase>package</phase>  
                    <goals>  
                        <goal>shade</goal>  
                    </goals>  
                    <configuration>  
                        <transformers>  
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">  
                                <mainClass>com.weiyigeek.main.maven.App</mainClass>  
                            </transformer>  
                        </transformers>  
                    </configuration>  
                </execution>  
            </executions>  
        </plugin>    
    </plugins>  
</build>
  
</project>

运行打包的 maven-0.0.1-SNAPSHOT.jar

PS E:\githubProject\Study-Promgram\JAVAWeb\Maven\maven\target> java -jar .\maven-0.0.1-SNAPSHOT.jar
Hello World! , Hello Maven!

0x02 Maven 私服

1.环境搭建

安装 - Install

私服(nexus)搭建几种方式:

1.Windows 、Linux、 Mac 运行即可
2.Docker 部署安装

Docker 部署

描述: 前提是您的计算机或者远程服务器已经安装并配置好Docker;

Github docker-nexus3 镜像帮助: https://github.com/sonatype/docker-nexus3#getting-help

案例演示:

# 1.创建持久化目录与指定用户ID授权
mkdir -pv /app/nexus3/data && chown -R 200 /app/nexus3/data

# 2.拉取镜像
$ docker search nexus3
# NAME                                      DESCRIPTION                                     STARS
# sonatype/nexus3                           Sonatype Nexus Repository Manager 3             896
$ docker pull sonatype/nexus3

# 3.容器构建即运行nexus3
$ docker run -id --privileged=true --name=maven-nexus3 --restart=always -p 8081:8081 -v /app/nexus3/data:/nexus-data sonatype/nexus3
# 参数解释：
# -id 创建守护式容器
# --privileged=true 授予root权限（挂载多级目录必须为true，否则容器访问宿主机权限不足）
# --name=名字 给你的容器起个名字
# -p 宿主机端口：容器端口映射
# -v 宿主机目录：容器目录 目录挂载

# 4.日志查看
docker logs -f --tail 50 maven-nexus3
# 2020-11-16 02:38:16,366+0000 INFO  [jetty-main-1] *SYSTEM org.eclipse.jetty.server.AbstractConnector - Started ServerConnector@48c1eded{HTTP/1.1, (http/1.1)}{0.0.0.0:8081}  # 表示初始化完成
# 2020-11-16 02:38:16,367+0000 INFO  [jetty-main-1] *SYSTEM org.eclipse.jetty.server.Server - Started @30452ms
# 2020-11-16 02:38:16,368+0000 INFO  [jetty-main-1] *SYSTEM org.sonatype.nexus.bootstrap.jetty.JettyServer -
# -------------------------------------------------
# Started Sonatype Nexus OSS 3.28.1-01
# -------------------------------------------------

# 5.查看初始化密码
cat /app/nexus3/data/admin.password

配置 - Configure 描述: 配置私服得远程Maven的镜像仓库加快下载速度;

Step 0.访问 maven.weiyigeek.top:8081 的 Nexus3 平台 Step 1.Setting -> Repository -> Create Repository Step 2.Create Repository: maven2 (proxy)om/repository/public

WeiyiGeek.Maven Mirror Proxy Setting

使用 - Usage

1) 本地 Maven 使用远程私有仓库配置 文件路径（环境有所不同请根据实际情况修改）: E:\Development\apache-maven-3.6.3-bin\conf\settings.xml

<mirrors>
  <!-- Maven 私服地址配置 -->
  <mirror>
      <id>private-maven</id>
      <mirrorOf>central</mirrorOf>
      <name>WeiyiGeek Private Maven</name>
      <url>http://maven.weiyigeek.top:8081/repository/maven-public/</url>
  </mirror>
</mirrors>

2) 上传本地jar到内部 Maven 私有仓库 描述: 大致可以通过三种方式进行上传Jar到内部 Maven 私有仓库中，第一种就是通过Web端上传，第二种通过mvn命令上传，第三种则是通过各开发工具上传例如IntelliJ IDEA.

通过 Sonatype Nexus Repository Manager 的 Web 页面进行上传Jar，操作流程Browse -> Upload-> Maven-release -> 选择要上传的jar包并设置该log4j-core.jar的组件相关信息。

<dependencies>
  <dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>2.16.0</version>
  </dependency>
</dependencies>

WeiyiGeek.通过Nexus Web上传jar包

通过 Maven 的 cmd 来上传自定义jar包, 首先需要先复制一份settings.xml为settings-private.xml，在settings-private.xml文件中加入节点server:

<server>
  <id>deployment</id>
  <username>dev</username>
  <password>dev123</password>
</server>

在命令行中输入

mvn deploy:deploy-file
-DgroupId=com.sjing.yjyuan
-DartifactId=fastjson-sj
-Dversion=1.0.1
-Dpackaging=jar
-Dfile=E:\installed\mavenRepository\fastjson-1.2.40.jar
-Durl=http://maven.weiyigeek.top/repository/maven-releases/
-DrepositoryId=deployment
--settings E:\installed\mavenRepository\settings-private.xml

通过IDE集成环境上传自定义jar包,首先还是在IDE集成环境中

<server>
  <id>nexus-release</id>
  <username>dev</username>
  <password>dev123</password>
</server>
<server>
  <id>nexus-snapshots</id>
  <username>dev</username>
  <password>dev123</password>
</server>

在maven工程项目nexus-upload中的pom文件中加入

<!--上传到nexus仓库中，配合mvn deploy:deploy-->
<distributionManagement>
 <repository>
     <!--这里的id需要和settings.xml中的server的id一致-->
     <id>nexus-release</id>
     <name>Nexus release Repository</name>
     <!--releases仓库-->
     <url>http://maven.weiyigeek.top/repository/maven-releases/</url>
 </repository>
 <snapshotRepository>
     <id>nexus-snapshots</id>
     <name>Nexus snapshots Repository</name>
     <!--snapshots仓库-->
     <url>http://maven.weiyigeek.top/repository/maven-snapshots/</url>
 </snapshotRepository>
</distributionManagement>

参考地址: https://www.cnblogs.com/tiancai/p/10063572.html https://www.cnblogs.com/endv/p/11204704.html https://blog.csdn.net/u013887008/article/details/79429973

问题 - Trouble Shooting

1) Nexus3.X 忘记密码之如何重置admin密码 解决办法:

# 1.进入容器
docker exec -it maven-nexus3 bash
bash-4.4$ cd /opt/sonatype/nexus/bin/
bash-4.4$ ls
contrib  nexus  nexus.rc  nexus.vmoptions  nexus.vmoptions.old
bash-4.4$ ls -alh ../lib/support/nexus-orient-console.jar
-rw-r--r-- 1 root root 6.6K Oct 14 18:24 ../lib/support/nexus-orient-console.jar

# 2.进入OrientDB控制台
# Linux、Windows、Mac有不同的进入方法，方法如下：
linux:  
  java -jar ./lib/support/nexus-orient-console.jar
win:  
  java -jar lib\support\nexus-orient-console.jar
mac: 
  .install4j/jre.bundle/Contents/Home/jre/bin/java -jar ./lib/support/nexus-orient-console.jar

# 3.登陆数据库
connect plocal:../sonatype-work/nexus3/db/security admin admin

# 4.重置密码，此处我们将admin用户密码重置为admin123
update user SET password="$shiro1$SHA-512$1024$NE+wqQq/TmjZMvfI7ENh/g==$V4yPw8T64UQ6GfJfxYq2hLsVrBY8D1v+bktfOxGdt4b/9BthpWPNUy/CBk6V9iA0nHpzYzJFWO8v/tZFtES8CA==" UPSERT WHERE id="admin"

# 5.退出shell重新运行nexus3容器
docker restart maven-nexus3

https://www.sonatype.com/nexus/repository-oss/download

配置到你本地maven的settings文件注意：是public group仓库地址而不是releases或snapshots仓库，public默认包含了这两个仓库

<profiles>
   <profile>  
   <id>dev</id>  
   <repositories>  
    <repository>  
       <id>local-nexus</id>
       <url>http://ip:8081/repository/maven-public/</url>  
       <releases>  
         <enabled>true</enabled>
       </releases>  
       <snapshots>  
         <enabled>true</enabled>  
       </snapshots>  
     </repository> 
   </repositories>  
 </profile>  
 </profiles>

 <activeProfiles>  
     <activeProfile>dev</activeProfile>  
   </activeProfiles>

配置maven settings文件的服务器用户名密码

注意：id为私服中releases和snapshots仓库名，必须一致 maven-releases admin admin123 maven-snapshots admin admin123

在项目父pom文件中配置部署环境，注意id及URL必须与nexus仓库对应

<!--私服仓库-->
<distributionManagement>
    <repository>
        <id>maven-releases</id>
        <name>Nexus Release Repository</name>
        <url>http://ip:8081/repository/maven-releases/</url>
    </repository>
    <snapshotRepository>
        <id>maven-snapshots</id>
        <name>Nexus Snapshot Repository</name>
        <url>http://ip:8081/repository/maven-snapshots/</url>
    </snapshotRepository>
</distributionManagement>

重新打开项目，对需要的模块进行deploy





```xml
在项目父pom文件中配置部署环境，注意id及URL必须与nexus仓库对应
    <!--私服仓库-->
    <distributionManagement>
        <repository>
            <id>maven-releases</id>
            <name>Nexus Release Repository</name>
            <url>http://192.168.3.128:8081/repository/maven-releases/</url>
        </repository>
        <snapshotRepository>
            <id>maven-snapshots</id>
            <name>Nexus Snapshot Repository</name>
            <url>http://192.168.3.128:8081/repository/maven-snapshots/</url>
        </snapshotRepository>
    </distributionManagement>

0x03 mvn 命令浅析

参数解析

-pl,--projects : 选项后可跟随{groupId}:{artifactId}或者所选模块的相对路径(多个模块以逗号分隔)
-am,--also-make : 表示同时处理选定模块所依赖的模块
-amd,--also-make-dependents : 表示同时处理依赖选定模块的模块
-N,--Non-recursive : 表示不递归子模块
-rf,--resume-from : 表示从指定模块开始继续处理
-X : 表示显示构建时的详细信息(Debug)

简单示例

# Maven 构建时显示详细信息
mvn install -X

# maven 下载单个源码包
mvn org.apache.maven.plugins:maven-dependency-plugin:2.8:get -Dartifact=javax.mail:mail:1.1:jar:sources

# Maven 导出依赖的jar包 (默认导出到targed/dependency 下面)
mvn dependency:copy-dependencies -DoutputDirectory=lib -DincludeScope=compile

实践示例

Maven之SpringBoot多模块编译以及单独构建多模块项目中的单个模块

# 首先切换到工程的根目录
# 可以通过pom.xml文件查看该POM项目包含的子模块
<modules>
  <module>weiyigeek-admin</module>
  <module>weiyigeek-front-login</module> # weiyigeek-admin 模块依赖于该模块
  <module>weiyigeek-front-search</module>
  <module>weiyigeek-front-pdf</module>
  <module>weiyigeek-front-history</module>
</modules>

# 方式1.构建该项目的所有模块项目，即 weiyigeek-* 所有项目
mvn clean package

# 方式2.只编译构建 weiyigeek-admin 项目
mvn clean install -pl org.top:weiyigeek-admin -am --settings settings.xml

# 方式3.编译构建 weiyigeek-admin 与 weiyigeek-front-login 项目
mvn clean install -pl weiyigeek-front-login -amd --settings settings.xml
 
# 方式4.从 weiyigeek-front-history 模块项目进行处理
mvn clean install -rf weiyigeek-front-history

# 方式5.只构建当前项目不构建子模块。
mvn clean install -N

温馨提示:

如果多模块项目没有互相引用，那么此时可以单独构建单个项目，指定到子模块的pom.xml文件即可完成编译。如果多模块项目各自都引用了，那么单独编译子模块的pom.xml文件会直接报错，解决方法就是编译父项目pom.xml。如果编译父项目，那么可能会造成编译时间很慢，其中有些项目也不需要编译，我们就可以采用上述 -pl 参数指定单模块。

本文参与腾讯云自媒体分享计划，分享自作者个人站点/博客。

原始发表：2020-02-08，如有侵权请联系 cloudcommunity@tencent.com 删除

https