Maven

最新推荐文章于 2025-05-06 23:38:51 发布

荒·湮

最新推荐文章于 2025-05-06 23:38:51 发布

阅读量144

点赞数 1

文章标签： python linux java 大数据 spring

本文链接：https://blog.youkuaiyun.com/pk5201314pk/article/details/119902459

版权

我们在开发一个Java项目的过程中需要依赖一些框架或组件的jar包，如果我们手动导入这些jar包，就需要我们清楚知道需要哪些jar包。例如SSH(SSM)框架，必须将其依赖的几十个jar包依次找出来并手动导入，非常繁琐。另外，导入的jar包通常还会依赖其他第三方jar包，一样需要手动将其导入，并不断重复这个过程，直到全部导入。在这个过程中，还可能会出现不同jar包依赖于一个同名的jar包，但版本却不同，导入jar包冲突，项目无法正常运行，这是一个很棘手的问题。我们可以使用Maven来避免这些问题，提高开发效率。

什么是Maven

Maven是基于项目对象模型(POM)，可以通过一小段描述信息来管理项目的构建，报告和文档的项目管理工具软件。对于不了解Maven的同学，是不是不明白上段话意思。其实，Maven的核心功能就是管理项目的依赖关系，是为了简化构建过程而设计的。因此，Maven是一个项目管理和整合工具。Maven工程结构和内容被定义在一个xml文件中——pom.xml，是 Project Object Model (POM) 的简称，此文件是整个Maven系统的基础组件。通过该文件，可以自动管理项目的依赖关系，下载需要的jar包。

安装Maven

Maven是一个基于Java的工具，所以要求已经安装了JDK。

系统要求
首先下载Maven，下载地址http://maven.apache.org/download.cgi，找到下载链接
Mac或Linux系统建议下载tar.gz格式的压缩包，Windows系统建议下载zip格式的压缩包。
下载后解压即可
如果需要在终端中使用Maven命令，就需要配置环境变量，类似于配置Java环境变量。
打开配置文件

open ~/.bash_profile

输入以下命令

export MAVEN_HOME=/opt/maven
export PATH=$PATH:$MAVEN_HOME/bin

保存后退出

：wq

使上面的配置生效

source ~.bash_profile

注意:如果path存在多个路径要用英文冒号：分隔，比如：

export PATH=$PATH:$JAVA_HOME/bin:$MAVEN_HOME/bin:/usr/local/mysql/bin

Maven仓库

在Maven的术语中，仓库是一个位置，是项目中依赖的第三方库，用于管理依赖、插件或者项目构建的输出，是存放构件(JAR、SOURCE、POMD等等)的地方。Maven仓库有三种类型本地仓库Maven的本地仓库会在第一次运行Maven命令的时候创建。当项目导入依赖或直接运行Maven命令时，所需要任何构件都会直接从本地仓库获取。如果本地仓库没有，它会首先尝试从远程仓库下载构件到本地仓库，然后再使用本地仓库的构件，起到缓存的作用。默认情况下，无论是Windows还是Mac系统，本地仓库是在自己的用户目录下的，仓库目录为%USER_HOME%/.m2/respository。

若要修改本地仓库的默认位置，可以在%MAVEN_HOME%/conf目录中配置文件setting.xml中指定位置。例如(Mac系统)

...
<localRepository>/data/maven/repository</localRepository>
...

中央仓库Maven中央仓库是由Maven社区提供的仓库，其中包含了大量常用的库。中央仓库包含了绝大多数流行的开源Java构件，以及源码、作者信息、SCM、信息、许可证信息等。一般来说，简单的Java项目依赖的构件都可以在这里下载到。中央仓库的地址是https://repo1.maven.org/maven2/。另外，还有一些其他著名的Maven仓库，例如JCenter、Sonatype等，我们可以访问https://mvnrepository.com/查找我们需要依赖构件。远程仓库如果Maven在中央仓库中也找不到依赖的构件，它会停止构建过程并输出错误信息到控制台。然而，在开发过程中，常有需要依赖内部Jar文件，比如自己封装基础类库、其他项目模块等等。由于Maven仓库是Maven社群维护的，我们并没有注册构件的权限，并且我们可能并不希望开源公司的内部类库或项目源码。为了解决这些问题，Maven提供了远程仓库的概念，任何一个机构或企业都可以建立自己的Maven仓库，我们称之为远程仓库。多级仓库结构由于中央仓库是面向全球所有Java开发者，并且服务器位于美国，如果直接从中央仓库下载文件，下载速度会非常缓慢。所以，除非必要，应尽量避免直接从中央仓库下载文件。

我们应该建立一个这样的多级仓库结构，来提高文件下载速度，提高工作效率。当我们执行Maven构建命令时，Maven开始安装以下顺序查找依赖的文件：

步骤1：在本地仓库中搜索，如果找不到执行步骤2，如果找到则继续执行其他操作。
步骤2：在远程仓库中搜索，如果找不到执行步骤3，如果找到则下载到本地仓库，然后继续执行其他操作。
步骤3：在中央仓库中搜索，如果找不到输出错误信息，如果找到则先下载到远程仓库，再从远程仓库下载到本地仓库，然后继续执行其他操作。远程仓库可以是一个或多个仓库，多个仓库之间可以是平级独立的，也可以上下级的依赖关系。

JitPack

JitPack实际上是一个自定义的Maven仓库，不过它的流程极度简化，可以直接依赖GitHub上的开源项目，不再需要将项目发布到自建的私库中，其他项目才可以将其作为依赖。

修改Maven的配置文件setting.xml文件，添加JitPack仓库的支持。

...
<profiles>
    <profile>
      <id>default</id>
      <repositories>
        <repository>
          <id>jitpack.io</id>
          <url>https://jitpack.io</url>
        </repository>
        <!-- 还可以添加其他仓库 -->
      </repositories>
    </profile>
  </profiles>
...

仓库镜像

无论是本地仓库还是远程私库，在国内直接访问Maven默认的远程中央仓库都特别慢。我们可以说使用国内的仓库镜像来提高下载文件的速度，比如阿里云镜像、网易镜像等。

修改Maven的配置文件setting.xml文件，添加镜像的支持。

<mirrors>
    <mirror>
      <id>aliyun</id>
      <!-- 匹配除jitpack.io之外的所有仓库，所有自建私库也应排除 -->
      <mirrorOf>*,!jitpack.io</mirrorOf>
      <!-- 镜像地址 -->
      <url>http://maven.aliyun.com/nexus/content/groups/public</url>
    </mirror>
  </mirrors>

setting.xml参考

<?xml version="1.0" encoding="UTF-8"?>
<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 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <!-- 本地仓库 -->
  <localRepository>/data/maven/repository</localRepository>

  <profiles>
    <profile>
      <id>default</id>
      <repositories>
        <repository>
          <id>jitpack.io</id>
          <url>https://jitpack.io</url>
        </repository>
      </repositories>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>default</activeProfile>
  </activeProfiles>

  <mirrors>
    <mirror>
      <id>aliyun</id>
      <mirrorOf>*,!jitpack.io</mirrorOf>
      <url>http://maven.aliyun.com/nexus/content/groups/public</url>
    </mirror>
  </mirrors> 

</settings>

IDEA的Maven配置

修改Maven根目录(Maven home directory)，选择我们下载并解压后的Maven根目录。
修改配置文件(User setting files)，先选中后边Override复选框，再选择我们自定义的Maven配置文件。
点击“Apply”，配置完成。
若是已经创建好的项目则需要打开“Preferences...”进行配置。

Maven工程项目

我们创建的Spring Boot项目默认就是使用Maven管理和构建的，也是一个Maven项目。

创建项目时，我们需要填写一下信息
Group：组织机构的全球唯一标识，一般以其域名的倒序来命名。例如公司域名是http://ysmz.cn/，那么本公司名义开发的所有项目Group以cn.ysmz来命名，并会生成相对路径cn/ysmz来存放Java代码。
Artifact：通用项目名称，建议多个单词之间以中杠“-”分隔。
Version：项目版本，默认为0.0.1-SNAPSHOT，其中0.0.1是版本号，SNAPSHOT(快照)标记该版本是开发版本、不稳定版本。
Packaging：打包机制，如Jar、War。
Name：用户描述项目名称，无关紧要，建议与Artifact保持一致。
Description：项目描述。
Package：源代码包路径，默认为Group+Artifact。
在Maven仓库中，根据Group、Artifact和Version就可以确定一个唯一的项目，这三个属性也就是项目的唯一坐标。项目结构
我们以Spring Boot项目为例来说明Maven的目录结构
src/main/java：Java源代码文件
src/main/resources：项目资源文件
src/test/java：单元测试的Java源代码文件
src/test/resources：单元测试的资源文件
pom.xml：管理项目依赖和构建
下面是一个刚创建的Spring Boot项目中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>
   <parent> <!-- 父项目的坐标 -->
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      <version>2.1.7.RELEASE</version>
      <relativePath/> <!-- lookup parent from repository -->
   </parent>
   <groupId>com.example</groupId>
   <artifactId>demo</artifactId>
   <version>0.0.1-SNAPSHOT</version>
   <name>demo</name>
   <description>Demo project for Spring Boot</description>

   <properties>
      <java.version>1.8</java.version>
   </properties>

   <dependencies>
      <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter</artifactId>
      </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>

parent父项目坐标，我们创建的项目是父项目的子项目。这里定义了Spring Boot的父级依赖，这样当前的项目就是Spring Boot了。spring-boot-starter-parent是一个特殊的starter，它用来提供相关的Maven默认依赖。使用它之后，常用的包依赖可以省去version标签。dependency添加依赖当项目需要依赖其他项目或组件时，只需要在该pom.xml配置文件中的和节点中加入新的即可。 我们需要知道所要加入的依赖的坐标，也就是它的Group、Artifact和Version，其中必需指定Group和Artifact，而Version有时可以省略。*

需要在项目中加入SpringMVC的支持，则在和中加入子节点

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

这是SpringBoot对SpringMVC的封装构件。
添加依赖的MySQL驱动

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>

添加依赖阿里巴巴的fastjson库

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.28</version>
</dependency>

添加依赖已托管至GitHub上的项目

<dependency>
    <groupId>com.sunnysuperman</groupId>
    <artifactId>ss-commons</artifactId>
    <version>0.2.4</version>
</dependency>

直接依赖GitHub上的数据库，需要配置JitPack，若在pom.xml中配置则仅对该项目有效，建议配置在Maven的配置文件setting.xml中。加入这些dependency后，Maven就会自动下载所需要的jar和相关的pom信息，并按照规则放在合适的位置，即/local_repository/groupId/artifactId/version/。例如，已知在Maven配置文件setting.xml中配置了本地仓库位置是“/data/maven/repository”，那么，Maven会自动帮我们下载fastjson构件至“/data/maven/repository/com/alibaba/fastjson/1.2.28/”目录下。

version

我们已经知道的引入依赖时version是有时省略的，比如与父项目(parent)保持一致，或是默认使用最新版本。建议不要默认使用最新版本，而是指定在当前项目中需要依赖的版本，防止被动升级依赖导致的问题。Maven的依赖关系是多层级的，例如A依赖于B，B又依赖于C，C还依赖于D，如此不限制依赖的层级数。但是，有可能A依赖于E，E又依赖于D，然而C和E是依赖于不同版本的D，会出现版本不一致的问题。Maven的以来调节机制就是为了解决版本不一致问题，采用就近原则。在该例中，A最终依赖的D的版本(version)将会是1.1，因为1.1版本对应的层级更少，也就是里A更近。

常见错误

程序包redis.clients.jedis不存在程序包com.alibaba.fastjson不存在

在pom.xml文件

<properties>
    <java.version>1.8</java.version>
</properties>

下方加入如下配置

<repositories>
        <repository>
            <id>jitpack.io</id>
            <url>https://jitpack.io</url>
        </repository>
 </repositories>