1. 首页
  2. 文章中心
  3. Maven

Maven系列 4.Maven项目基础

122 阅读 0 评论
我是靠谱客的博主 唠叨小蝴蝶，最近开发中收集的这篇文章主要介绍Maven系列 4.Maven项目基础，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

4. Maven项目基础

    Maven为其所有项目提供了约定和标准目录布局。如第1章所讨论的，这个标准化提供了一个统一的构建接口，它也使得开发人员可以轻松地从一个项目跳转到另一个项目。本章将解释Maven项目和pom.xml文件的基础知识。


     基础项目组织
    理解Maven项目结构的最好方法是查看一个。图4-1说明了一个基于Maven的Java项目。


图4-1。 Maven Java项目结构
    现在让我们看看项目中的每个组件：    
      gswm是项目的根文件夹。通常，项目的名称与生成的工件的名称匹配。
      src文件夹包含项目相关工件，您通常希望在源控制管理（SCM）系统（如SVN或Git）中进行管理。
      src / main / java文件夹包含Java源代码。
      src / test / java文件夹包含Java单元测试代码。
      目标文件夹保存生成的工件，例如.class文件。生成的工件通常不存储在SCM中，因此不要将目标文件夹及其内容提交到SCM。
      每个Maven项目在项目的根目录都有一个pom.xml文件。它保存项目和配置信息，例如依赖项和插件。
    除了src / main和src / test目录，Maven还推荐了其他几个目录。表4-1列出了这些目录及其中的内容。    
      表4-1。 Maven目录
目录名称              说明
             src / main / resources
              保存需要在生成的工件中结束的资源，例如Spring配置文件和速度模板。           
              src / main / config
              保存配置文件，例如Tomcat上下文文件，James Server配置文件等。这些文件不会在生成的工件中结束。
              src / main / scripts
              保存系统管理员和开发人员对应用程序所需的任何脚本。
               src / test / resources
             保存测试所需的配置文件。
              src / main / webapp
              保存Web资源（如.jsp文件，样式表和图像）。
              src / it
              保存应用程序的集成测试。
              src / main / db
              保存数据库文件，例如SQL脚本。
              src / site
              保存生成项目站点期间所需的文件。
    Maven提供了原型（如第6章所讨论的）快速引导项目的概念。但是，在本章中，您将手动组合项目。使用以下说明创建项目：
    使用命令行，转到要创建项目的文件夹。在本书中，我们假设目录为c： apress gswm-book chapter4。
      运行命令mkdir gswm。
      cd进入新创建的目录，并创建一个空的pom.xml文件。
      创建目录src / main / java。在gswm下创建src目录，然后在src中创建主目录，最后在main下创建java目录，如图4-2所示。

    起始项目结构应类似于图4-2所示。


图4-2。 Maven项目结构

了解pom.xml文件
    pom.xml文件是Maven项目中唯一需要的工件。正如我们在本书中讨论的那样，pom.xml文件保存了Maven所需的配置信息。清单4-1显示了带有基本项目信息的pom.xml文件。我们使用project元素启动pom.xml文件。然后我们提供groupId，artifactId和版本坐标。包装元素告诉Maven它需要为此项目创建一个JAR存档。最后，我们添加有关正在处理此项目的开发人员的信息。
    列表4-1。 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.apress.gswmbook
</groupId>
<artifactId>gswm
</artifactId>
<version>1.0.0-SNAPSHOT
</version>
<packaging>jar
</packaging>
<name>Getting Started with Maven
</name>
<url>http://apress.com
</url>
<developers>
<developer>
<id>balaji
</id>
<name>Balaji Varanasi
</name>
<email>balaji@inflinx.com
</email>
<properties>
<active>true
</active>
</properties>
</developer>
<developer>
<id>sudha
</id>
<name>Sudha Belida
</name>
<email>sudha@inflinx.com
</email>
<properties>
<active>true
</active>
</properties>
</developer>
</developers>
</project>
我们将在本章后面以及本书其余部分的pom.xml文件中查看其他元素。
      MAVEN VERSIONING
      建议Maven项目使用以下约定进行版本控制：
      <major-version>。<minor-version>。<incremental-version> -qualifier
      主要，次要和增量值是数字，限定符可以具有值，例如RC，alpha，beta和SNAPSHOT。遵循该惯例的一些示例是1.0.0,2.4.5-SNAPSHOT，3.1.1-RC1等等。
      项目版本中的SNAPSHOT限定符具有特殊的含义。这表明该项目处于开发阶段。当项目使用SNAPSHOT依赖项时，每次构建项目时，Maven将获取并使用最新的SNAPSHOT工件。
      大多数存储库管理器只接受发布版本一次。但是，当您在持续集成环境中开发应用程序时，您希望经常构建并将最新版本推送到存储库管理器。因此，最好的做法是在开发期间使用SNAPSHOT来后缀您的版本。 


    构建项目
    在我们看看构建项目之前，让我们在src / main / java文件夹下添加HelloWorld Java类。清单4-2显示了HelloWorld类的代码。
    清单4-2。 HelloWorld Java类的代码    
public class HelloWorld {public void sayHello（）{

System.out.print（“Hello World”）; 

}}
}}

    图4-3显示了添加类后的项目结构。


      图4-3。添加了Java类的项目结构
    现在你准备好构建应用程序，让我们从gswm运行mvn包。您应该看到类似于清单4-3所示的输出。
    代码4-3。用于构建应用程序的Maven软件包命令的输出

C:apressgswm-bookchapter4gswm>mvn package
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building Getting Started with Maven 1.0.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ gswm ---
[WARNING] Using platform encoding (Cp1252 actually) to copy filtered resources,i.e. build is platform dependent!
[INFO] skip non existing resourceDirectory C:apressgswm-bookchapter4gswmsrcmainresources
[INFO]
[INFO] --- maven-compiler-plugin:2.5.1:compile (default-compile) @ gswm ---
[WARNING] File encoding has not been set, using platform encoding Cp1252, i.e. build is platform dependent!
[INFO] Compiling 1 source file to C:apressgswm-bookchapter4gswmtargetclasses
[INFO]
[INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ gswm ---
[WARNING] Using platform encoding (Cp1252 actually) to copy filtered resources,i.e. build is platform dependent!
[INFO] skip non existing resourceDirectory C:apressgswm-bookchapter4gswmsrctestresources
[INFO]
[INFO] --- maven-compiler-plugin:2.5.1:testCompile (default-testCompile) @ gswm---
[INFO] No sources to compile
[INFO]
[INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ gswm ---
[INFO] No tests to run.
[INFO]
[INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ gswm ---
[INFO] Building jar: C:apressgswm-bookchapter4gswmtargetgswm-1.0.0-SNAPSHOT.jar
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1.269s
[INFO] Finished at: Mon Oct 13 21:40:44 MDT 2014
[INFO] Final Memory: 9M/23M
[INFO] ------------------------------------------------------------------------
注意如果这是你第一次运行Maven，它将下载它运行所需的插件和依赖关系。因此，您的第一次构建可能需要比预期更长的时间。
        mvn命令之后的包后缀是一个Maven阶段，用于编译Java代码并将其打包到JAR文件中。打包的JAR文件出现在gswm target文件夹中，如图4-4所示。

图4-4。位于目标文件夹下的打包JAR
    
    测试项目
    现在您已经完成了项目构建，让我们添加一个测试sayHello（）方法的JUnit测试。让我们通过将JUnit依赖项添加到pom.xml文件来开始此过程。您可以通过使用dependencies元素来完成此任务。代码清单4-4显示了具有JUnit依赖关系的更新的pom.xml文件。
    代码4-4。使用JUnit依赖关系更新了POM

<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.apress.gswmbook
</groupId>
<artifactId>gswm
</artifactId>
<version>1.0.0-SNAPSHOT
</version>
<packaging>jar
</packaging>
<name>Getting Started with Maven
</name>
<url>http://apress.com
</url>
<developers>
<developer>
<id>balaji
</id>
<name>Balaji Varanasi
</name>
<email>balaji@inflinx.com
</email>
<properties>
<active>true
</active>
</properties>
</developer>
<developer>
<id>sudha
</id>
<name>Sudha Belida
</name>
<email>sudha@inflinx.com
</email>
<properties>
<active>true
</active>
</properties>
</developer>
</developers>
<dependencies>
<dependency>
<groupId>junit
</groupId>
<artifactId>junit
</artifactId>
<version>4.11
</version>
<scope>test
</scope>
</dependency>
</dependencies>
</project>

    请注意，您已使用范围测试，指示仅在测试阶段需要JUnit .jar。让我们通过在命令行中运行mvn dependency：tree来确保这个依赖关系已经成功添加。清单4-5显示了此操作的输出。
    清单4-5。 Maven树命令输出     
C:apressgswm-bookchapter4gswm>mvn dependency:tree
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building Getting Started with Maven 1.0.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-dependency-plugin:2.8:tree (default-cli) @ gswm ---
[INFO] com.apress.gswmbook:gswm:jar:1.0.0-SNAPSHOT
[INFO] - junit:junit:jar:4.11:test
[INFO]
- org.hamcrest:hamcrest-core:jar:1.3:test
[INFO] ----------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ----------------------------------------------------------
[INFO] Total time: 1.646s
[INFO] Finished at: Mon Oct 13 21:54:24 MDT 2014
[INFO] Final Memory: 7M/19M
[INFO] ----------------------------------------------------------
    依赖性插件中的树目标将项目的依赖项显示为树。请注意，JUnit依赖项在一个名为hamcrest的传递依赖项中，它是一个开源项目，可以很容易地编写匹配器对象。
现在你在类路径中有JUnit依赖项，让我们向项目中添加一个单元测试HelloWorldTest.java。 在src下创建文件夹test / java，并在它下面添加HelloWorldTest.java。 更新的项目结构如图4-5所示。

       图4-5。 Maven结构与测试类
     HelloWorldTest的源代码如清单4-6所示。
    清单4-6。 HelloWorldTest Java类的代码 
import java.io.ByteArrayOutputStream;import java.io.PrintStream;import org.junit.After;import org.junit.Assert;import org.junit.Before;import org.junit.Test;public class HelloWorldTest
{
private final ByteArrayOutputStream outStream = new ByteArrayOutputStream();
@Before
public void setUp()
{
System.setOut(new PrintStream(outStream));
}
@Test
public void testSayHello()
{
HelloWorld hw = new HelloWorld();
hw.sayHello();
Assert.assertEquals("Hello World", outStream.toString());
}
@After
public void cleanUp()
{
System.setOut(null);
}
}

     您现在已经在此项目中设置了所有内容，因此您可以再次运行mvn软件包。 运行它之后，您将看到类似于清单4-7所示的输出。
     列表4-7。 用于构建项目的Maven命令的输出 

C:apressgswm-bookchapter4gswm>mvn package
[INFO] Scanning for projects...
[INFO]
[INFO] ---------------------------------------------------------------
[INFO] Building Getting Started with Maven 1.0.0-SNAPSHOT
[INFO] ---------------------------------------------------------------
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ gswm ---
[WARNING] Using platform encoding (Cp1252 actually) to copy filtered resources,i.e. build is platform dependent!
[INFO] skip non existing resourceDirectory C:apressgswm-bookchapter4gswmsrcmainresources
[INFO]
[INFO] --- maven-compiler-plugin:2.5.1:compile (default-compile) @ gswm ---
[INFO] Nothing to compile - all classes are up to date
[INFO]
[INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ gswm --------------------------------------------------------
[INFO] Surefire report directory: C:apressgswm-bookchapter4gswmtargetsurefire-reports------------------------------------------------------- T E S T S-------------------------------------------------------Running HelloWorldTestTests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.038 secResults :Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO]
[INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ gswm ---
[INFO] Building jar: C:apressgswmbookchapter4gswmtargetgswm-1.0.0-SNAPSHOT.jar
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1.807s
[INFO] Finished at: Mon Oct 13 21:59:57 MDT 2014
[INFO] Final Memory: 9M/22M
[INFO] --------------------------------------------------------------------
注意代码4-7中的Tests部分。它显示Maven已运行测试，并已成功完成。

      图4-6。具有测试类的目标文件夹

    图4-6显示了更新的目标文件夹。您可以看到现在有一​​个test-classes文件夹及其在该文件夹中的关联报告。


    pom.xml中的属性
    Maven允许您使用<properties />元素在pom.xml文件中声明属性。这些属性对于声明依赖关系版本非常有用。代码清单4-8显示了更新的pom.xml文件，其中JUnit版本声明为属性。注意在JUnit依赖关系的版本元素中使用$ {}语法。这在pom.xml有很多依赖项并且需要知道或更改特定依赖项的版本时尤其有用。
    代码4-8。 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.apress.gswmbook
</groupId>
<artifactId>gswm
</artifactId>
<version>1.0.0-SNAPSHOT
</version>
<packaging>jar
</packaging>
<name>Getting Started with Maven
</name>
<url>http://apress.com
</url>
<properties>
<junit.version>4.11
</junit.version>
</properties>
<developers>
<developer>
<id>balaji
</id>
<name>Balaji Varanasi
</name>
<email>balaji@inflinx.com
</email>
<properties>
<active>true
</active>
</properties>
</developer>
<developer>
<id>sudha
</id>
<name>Sudha Belida
</name>
<email>sudha@inflinx.com
</email>
<properties>
<active>true
</active>
</properties>
</developer>
</developers>
<dependencies>
<dependency>
<groupId>junit
</groupId>
<artifactId>junit
</artifactId>
<version>${junit.version}
</version>
<scope>test
</scope>
</dependency>
</dependencies>
</project>

排除依赖关系
     第3章讨论了传递依赖和偶尔需要排除一个特定的传递依赖。 pom.xml文件中的exclude元素允许您排除依赖关系。
     清单4-9显示了排除hamcrest传递依赖关系的JUnit的更新依赖关系元素。 如您所见，排除元素采用您想要排除的依赖关系的groupId和artifactId坐标。
     代码4-9。 JUnit依赖与排除 
<dependencies>
<dependency>
<groupId>junit
</groupId>
<artifactId>junit
</artifactId>
<version>${junit.version}
</version>
<scope>test
</scope>
<exclusions>
<exclusion>
<groupId> org.hamcrest
</groupId>
<artifactId>hamcrest
</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>


总结
     Maven的CoC为其所有项目规定了标准目录布局。 它提供了几个敏感的目录，如src main java和src it，以及对每个目录的内容的建议。 您学习了强制性的pom.xml文件及其一些元素，用于配置Maven项目的行为。


     在下一章中，您将看到Maven的生命周期，插件，构建阶段，目标以及如何有效地利用它们。

最后

以上就是唠叨小蝴蝶为你收集整理的Maven系列 4.Maven项目基础的全部内容，希望文章能够帮你解决Maven系列 4.Maven项目基础所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错，欢迎将靠谱客网站推荐给程序员好友。

本图文内容来源于网友提供，作为学习参考使用，或来自网络收集整理，版权属于原作者所有。
点赞(81)

相关文章

vite 2vite
vite 2vite
Maven的scope详解依赖范围介绍依赖传递依赖范围与 classpath 的关系表参考
Maven的scope详解依赖范围介绍依赖传递依赖范围与 classpath 的关系表参考
Maven问题总结参考
Maven问题总结参考
Maven系列第6篇：生命周期和插件详解，此篇看过之后在maven的理解上可以超越同级别90%的人！
Maven系列第6篇：生命周期和插件详解，此篇看过之后在maven的理解上可以超越同级别90%的人！
Maven系列 4.Maven项目基础
Maven系列 4.Maven项目基础
maven中scoped的使用
maven中scoped的使用
管理工具---Maven系列（零）Maven
管理工具---Maven系列（零）Maven
Vite 基本配置及原理介绍vite.config.js
Vite 基本配置及原理介绍vite.config.js

评论列表共有 0 条评论

立即
投稿
返回
顶部