pom.xml文件详解

原文地址：https://blog.csdn.net/l00149133/article/details/78923873
Spring项目实践（一）---pom.xml文件详解

一. maven的信息部分
 

<?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/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>

    解释：
    头部的信息主要是定义了xml的版本，编码格式（UTF-8），以及最顶层的project标签，另外也定义了modelVersion，这里需要注意的是，如果你使用的是maven2或者maven3，那么这个modelVersion只能是4.0.0。
    二.project的基本信息
    <name>frBlog</name>
    <groupId>com.frweb</groupId>
    <artifactId>frBlog</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>war</packaging>
    解释：
    name是项目的名字。
    groupId，artifactId和version构成了一个maven项目的坐标（可以唯一定位一个maven项目）

    <dependency>
        <groupId>org.springframework.data</groupId>
        <artifactId>spring-data-redis</artifactId>
        <version>1.4.2.RELEASE</version>
    </dependency>

    这个示例在仓库中的项目路径是这样的：org\springframework\data\spring-data-redis 从上面这个目录我们可以看出，groupId决定的是项目的前几级目录，artifactId定义的是第四级目录，
    而通常用版本编号来定义最后一级目录 然后在版本目录下就是我们具体的项目jar包
    version中的SNAPSHOT表示当前版本是一个不稳定的，尚处于开发中的版本
    声明一个确切的版本（将始终解析为1.0.1）： <version>[1.0.1]</version> 声明一个显式版本（除非发生冲突，否则将始终解析为1.0.1，当Maven将选择匹配版本时）： <version>1.0.1
</version> 声明所有1.x的版本范围（目前将解析为1.1.1）： <version>[1.0.0,2.0.0)</version> 声明一个开放式版本范围（将解析为2.0.0）： <version>[1.0.0,)
</version> 将版本声明为SNAPSHOT：也就是告诉别人这是开发中的快照的版本，快照版本一般更迭很快，所以属于不稳定版本 <version>SNAPSHOT</version> 将版本声明为RELEASE：也就是告诉别人这是正式发布的版本，这一般就是稳定而不会再进行改变的版本 <version>
    RELEASE
</version> 基本的声明样式，数字的变化是指我们在代码中修复了BUG或者优化了一些小的部分，大的改动变化的就是最前面的版本号 <version>版本号.版本定义</version>
    <version>1.4.2.SNAPSHOT</version>
    <version>1.4.2.RELEASE</version> 一般在开发模式下，我们可以频繁的发布SNAPSHOT版本，以便让其它项目能实时的使用到最新的功能做联调；当版本趋于稳定时，
    再发布一个正式版本，供正式使用。当然在做正式发布时，也要确保当前项目的依赖项中不包含对任何SNAPSHOT版本的依赖，保 证正式版本的稳定性。
    这里需要注意的是快照版本与发布版本本质上没有什么区别，只是在版本号上做一个是否稳定的说明。
    packaging表示项目打包的方式，有以下值：pom, jar, maven-plugin, ejb, war, ear, rar, par。通常web项目默认的是war，另一种比较常用得就是Jar包。
    三.定义私有仓库repositories
    <repositories>
        <repository>        <!--id是定义了我们私有仓库的id-->
            <id>fr-nexus</id>
            <--!url这部分是关键，是我们私有仓库的地址----我们使用Nexus来创建我们的私有仓库-->        <url>
                http://nexus.frBlog.com/nexus/content/groups/public/
            </url>        <!--snapshots：是否允许下载SNAPSHOTS版本，也就是不稳定版本。类似的标签还有releases。-->
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
        </repository>
    </repositories>
    repositories本来就是仓库的意思。
    这部分的内容不是必须的，因为maven有自己默认的中央仓库，或者我们可以在MAVEN的设置文件中设置仓库。
    如果我们仅使用中央仓库（没有自己自定义一些jar包），而不需要自己的私有仓库的话，是不需要写这一部分的。但在企业级的项目中，通常会使用企业自己的私有仓库，而又不想改变MAVEN的设置文件的话，就可以在这里进行设置。
    四.依赖库dependencies
    依赖库可以说是pom文件的核心，我们项目中用到的依赖包都要写到这部分里来。
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>3.8.1</version>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
            <version>2.5</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>2.1</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
        </dependency>
    </dependencies>
    可以看到这部分的内容其实就是我们上面project基本信息的内容。
    可以用groupId，artifactId和version来定义唯一的一个maven项目 另外有个标签scope，表明了依赖的范围，这个标签通常有这么几种赋值：
    --compile，也是默认值。它表示这个被依赖的maven项目会参与项目编译，测试和运行，打包的话也会将这个项目打包进去。 --这是一个比较强的依赖范围
    --test，表示这个被依赖的maven项目仅参与测试代码的编译和运行，比较典型的是junit --runtime，表示被依赖项目无需参与项目的编译，不过后期的测试和运行周期需要其参与。与compile相比，跳过编译而已
    --provided，表示只有当JDK或者一个容器已经提供了这个依赖后才使用。例如，如果你开发了一个web应用，你可能在编译 --classpath的过程中需要可用的servlet
    API来编译一个servlet。但是你不会想要在打包好的war文件中包含这个servlet API。
    --这个API会由你的应用服务器或者servlet容器来提供（比如tomcat）。也就是说，provided依赖在编译classpath是可用， --他不是传递性的，也不会被打包
    --system，与provided类似，但是你必须显式的提供一个本地jar包的路径（systemPath）
    五.build编译部分
    <build>
        <finalName>cnzz</finalName>
        <defaultGoal>install</defaultGoal>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <configuration>
                    <skip>true</skip>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>2.5.1</version>
                <configuration>
                    <source>1.6</source>
                    <target>1.6</target>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
        </plugins>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <filtering>true</filtering>
            </resource>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.xml</include>
                    <include>**/*.properties</include>
                </includes>
            </resource>
        </resources>
    </build>
    解释如下：
    build标签有两种。 上面我们写的这种，是直接在project下面的标签，还有一种，是在profile下面的标签，这个我们后面会讲到。
    其中，finalName是最终编译生成的名字，比如如果最终我们生成了一个.war文件，那么这个文件的名字就是finalName.war
    defaultGoal是执行构建时默认的goal或phase，如jar:jar或者package等 plugins给出构建过程中所用到的插件。 这里我们常用到的插件有：
    maven-compiler-plugin插件，因为maven的核心插件compile插件默认只支持编译JAVA1.3，
    如果你要使用java6，必须要使用这个maven-compiler-plugin插件才可以使用JAVA的更高版本。 maven-surefire-plugin插件，这个插件用来在maven构建生命周期的test
    phase执行一个应用的单元测试。 使用这个插件后，你可以使用mvn surefire:test或者mvn test可以运行工程下的单元测试。
    resources标签，通常这里面放的是我们项目的各种资源，最常见的就是.properties文件，用来定义一些编译时用到的变量。 directory标签，制定了资源的路径
    filtering是否开启filtering功能。filtering主要用来替换项目中的资源文件（.xml、.properties）当中的...，
    比如...，比如{db.url}，那么如果配置了db.url=aaa的话，在项目编译的时候，就会自动的把${db.url}替换为aaa
    includes标签，配置包含了directory下面哪些文件，如果不陪着includes，那就默认包含directory的所有文件
    六.profiles部分
    允许在pom.xml里面定义若干个profile段，然后在编译时选择其中的一个用于覆盖项目文件原先的定义。
    最经常被用来配置不用的环境，比如生产环境和开发环境
    这里我们定义了2个profile，分别是dev和prod。dev是开发环境，prod是生产环境。
    这样如果我们运行
    mvn clean compile -P dev
    那么使用的就是dev的配置参数。
    <profiles>
        <profile>
            <id>dev</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <build>
                <finalName>cnzz1</finalName>
                <filters>
                    <filter>profile-dev.properties</filter>
                </filters>
                <pluginManagement>
                    <plugins>
                        <plugin>
                            <groupId>org.apache.tomcat.maven</groupId>
                            <artifactId>tomcat7-maven-plugin</artifactId>
                            <version>2.2</version>
                            <configuration>
                                <path>/cnzzdata</path>
                                <port>8888</port>
                                <uriEncoding>UTF-8</uriEncoding>
                                <url>http://localhost:8888/manager/text</url>
                                <server>tomcat8
                                </server>                        <!--<tomcatLoggingFile>log.txt</tomcatLoggingFile>-->
                                <contextReloadable>true</contextReloadable>
                            </configuration>
                        </plugin>
                    </plugins>
                </pluginManagement>
            </build>
        </profile>
        <profile>
            <id>prod</id>
            <build>
                <finalName>cnzzdata.prod</finalName>
                <filters>
                    <filter>profile-prod.properties</filter>
                </filters>
            </build>
        </profile>
    </profiles>
    看一下里面的细节：
    id就是profile的id，也是我们运行mvn clean compile -P id的参数 activeByDefault是指的默认编译环境，如果这个值为true，那当我们没有指定使用哪个profile的时候，
    默认就会用activeByDefault=true的profile。这里我们设置了dev的activeByDefault=true，所以： mvn clean compile = mvn clean compile -P dev
    profile里也有build标签，这里build标签指的是这个profile的编译配置，具体内容同上面我们说的build
    七.pluginRepositories插件仓库
    <!--简单言之 就是插件的仓库，字段同上面的仓库类似，不再赘述-->
    <pluginRepositories>
        <pluginRepository>
            <id>apache.snapshots</id>
            <name>Apache Snapshots</name>
            <url>http://repository.apache.org/content/groups/snapshots-group/</url>
            <releases>
                <enabled>false</enabled>
            </releases>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
        </pluginRepository>
    </pluginRepositories>
    八.properties定义常量
    <properties>
        <springframework-version>3.2.2.RELEASE</springframework-version>
        <spring.security.version>3.2.3.RELEASE</spring.security.version>
        <spring.version>3.2.11.RELEASE</spring.version>
        <slf4j.version>1.7.5</slf4j.version>
    </properties>
    这里比较简单，第一次定义项目中的常量，而是定义可能在项目更新中更新的比较快的依赖，写在这里比较容易统一更改。
    <!-- spring核心包 开始-->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-oxm</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-tx</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jdbc</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-aop</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context-support</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-test</artifactId>
        <version>${spring.version}</version>
    </dependency> <!-- spring核心包 结束-->
    上面的依赖就通过表达式去联系到上面的常量，这样可以一次性更改多个依赖的版本，也不用定义多次，避免升级依赖版本的时候漏改。省时省力。