Maven 中的 classifier 属性用过没？

最近训练营有小伙伴问到松哥一个关于 Maven 依赖的问题，涉及到 classifier 属性，随机问了几个小伙伴，都说工作中没用到过，因此简单整篇文章和小伙伴们分享下。

Maven 大家日常开发应该都有使用，Maven 中有一个比较好玩的 classifier 属性不知道小伙伴们有没有用过？

简单聊一聊这个话题。

一 Classifier 属性的作用

Classifier 属性在 Maven 中的主要作用是用于区分同一 artifact 的不同版本或变种。在 Maven 的坐标系统中，一个 artifact 通常由 groupId、artifactId 和 version 三个基本元素确定。

然而，在某些情况下，我们可能需要为同一个 artifact 创建多个不同的版本或变种，比如源代码包、文档包或特定平台的二进制包等。这时，Classifier属性就派上了用场。

通过为 artifact 添加 Classifier 属性，我们可以为同一个 artifact 创建多个不同的附件（attachment）。这些附件可以是源代码、测试代码、文档、特定平台的二进制文件等。每个附件都有一个唯一的 Classifier 值，用于区分它们。这样，我们就可以在 Maven 仓库中存储和管理这些不同的 artifact 变种，并在构建过程中根据需要引用它们。

例如下面这张图：

如果我想引用第一个 shiro-web-2.0.0-jakarta.jar 该怎么写呢？下面这种写法显然不对，这种写法引入的是 shiro-web-2.0.0.jar。

<dependency><groupId>org.apache.shiro</groupId><artifactId>shiro-web</artifactId><version>2.0.0</version>
</dependency>

二 在依赖中引用Classifier

当我们需要在其他 Maven 项目中引用具有 Classifier 的 artifact 时，我们需要在依赖声明中指定 classifier 属性。例如：

<dependencies>  <dependency>  <groupId>com.example</groupId>  <artifactId>my-artifact</artifactId>  <version>1.0.0</version>  <classifier>sources</classifier>  <type>jar</type>  <scope>compile</scope>  </dependency>  
</dependencies>

在上面的示例中，我们引用了一个 Classifier 值为 sources 的 artifact 变种。Maven 将根据 groupId、artifactId、version 和 classifier 的值在仓库中查找相应的 artifact，并将其添加到项目的依赖中。

如果是上面的 Shiro 依赖呢？写法如下：

<dependency><groupId>org.apache.shiro</groupId><artifactId>shiro-web</artifactId><version>2.0.0</version><classifier>jakarta</classifier>
</dependency>

三 自定义 Classifier 属性

上面是我们引用别人的项目，配置 Classifier，如果要在自己的 Maven 项目中定义 Classifier，那么我们需要在 pom.xml 文件中进行相应的配置。具体来说，我们需要在 build 标签下添加 maven-jar-plugin 插件，并为其配置 classifier 属性。例如，如果我们想要创建一个包含源代码的 artifact 变种，可以这样做：

<build>  <plugins>  <plugin>  <groupId>org.apache.maven.plugins</groupId>  <artifactId>maven-jar-plugin</artifactId>  <version>3.2.0</version>  <executions>  <execution>  <goals>  <goal>jar</goal>  </goals>  </execution>  <execution>  <id>attach-sources</id>  <goals>  <goal>jar</goal>  </goals>  <configuration>  <classifier>sources</classifier>  </configuration>  </execution>  </executions>  </plugin>  </plugins>  
</build>

在上面的示例中，我们为 maven-jar-plugin 插件添加了一个名为 attach-sources 的执行，并为其配置了 classifier 属性为 sources。这表示我们将创建一个包含源代码的 artifact 变种，其 Classifier 值为 sources。

四 总结

Maven 的 Classifier 属性为我们在构建和管理 Java 项目时提供了极大的灵活性。通过为 artifact 添加 Classifier 属性，我们可以创建多个不同的版本或变种，以满足不同的项目需求或构建环境。同时，我们还可以在依赖声明中引用具有 Classifier 的 artifact，从而轻松地将其集成到其他项目中。