Spring项目实践（一）---pom.xml文件详解

现在我们大部分的JAVA开发都会用到maven了（当然Android开发更常用的是gradle）。Spring也是我们开发JAVA WEB项目最常用的框架之一，这篇就来讲一下，Spring项目中使用maven的pom.xml应该如何配置。

我们来一部分一部分的看下pom文件
一. maven的信息部分

<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.0modelVersion>

头部的信息主要是定义了xml的版本，编码格式（UTF-8），以及最顶层的project标签，另外也定义了modelVersion，这里需要注意的是，如果你使用的是maven2或者maven3，那么这个modelVersion只能是4.0.0

二.project的基本信息

    <name>frBlogname>
    <groupId>com.frwebgroupId>
    <artifactId>frBlogartifactId>
    <version>0.0.1-SNAPSHOTversion>
    <packaging>warpackaging>

name是项目的名字。
groupId，artifactId和version构成了一个maven项目的坐标（可以唯一定位一个maven项目）
version中的SNAPSHOT表示当前版本是一个不稳定的，尚处于开发中的版本
packaging表示项目打包的方式，有以下值：pom, jar, maven-plugin, ejb, war, ear, rar, par。通常web项目默认的是war

三.定义私有仓库repositories
repositories本来就是仓库的意思。
这部分的内容不是必须的，因为maven有自己默认的中央仓库，如果我们仅使用中央仓库（没有自己自定义一些jar包），而不需要自己的私有仓库的话，是不需要写这一部分的。

<repositories>
    <repository>
        <id>fr-nexusid>
        <url>http://nexus.frBlog.com/nexus/content/groups/public/url>
        <snapshots>
            <enabled>trueenabled>
        snapshots>
    repository>
repositories>

这里id是定义了我们私有仓库的id
url这部分是关键，是我们私有仓库的地址（我们使用Nexus来创建我们的私有仓库）
snapshots：是否允许下载SNAPSHOTS版本，也就是不稳定版本。类似的标签还有releases。

四.依赖库dependencies
这部分可以说是pom文件的核心，我们项目中用到的依赖包都要写到这部分里来

    <dependencies>
        <dependency>
            <groupId>junitgroupId>
            <artifactId>junitartifactId>
            <version>3.8.1version>
        dependency>
        <dependency>
            <groupId>javax.servletgroupId>
            <artifactId>servlet-apiartifactId>
            <version>2.5version>
            <scope>providedscope>
        dependency>
        <dependency>
            <groupId>javax.servlet.jspgroupId>
            <artifactId>jsp-apiartifactId>
            <version>2.1version>
            <scope>providedscope>
        dependency>
        <dependency>
            <groupId>javax.servletgroupId>
            <artifactId>jstlartifactId>
            <version>1.2version>
        dependency>

截取了其中的一部分。
可以看到这部分的内容其实就是我们上面project基本信息的内容。
可以用groupId，artifactId和version来定义唯一的一个maven项目
另外有个标签scope，表明了依赖的范围，这个标签通常有这么几种赋值：
1. compile，也是默认值。它表示这个被依赖的maven项目会参与项目编译，测试和运行，打包的话也会将这个项目打包进去。这是一个比较强的依赖范围
2. test，表示这个被依赖的maven项目仅参与测试代码的编译和运行，比较典型的是junit
3. runtime，表示被依赖项目无需参与项目的编译，不过后期的测试和运行周期需要其参与。与compile相比，跳过编译而已
4. provided，表示只有当JDK或者一个容器已经提供了这个依赖后才使用。例如，如果你开发了一个web应用，你可能在编译classpath的过程中需要可用的servlet API来编译一个servlet。但是你不会想要在打包好的war文件中包含这个servlet API。这个API会由你的应用服务器或者servlet容器来提供（比如tomcat）。也就是说，provided依赖在编译classpath是可用，他不是传递性的，也不会被打包
5. system，与provided类似，但是你必须显式的提供一个本地jar包的路径（systemPath）

五.build编译部分

    <build>
        <finalName>cnzzfinalName>
        <defaultGoal>installdefaultGoal>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.pluginsgroupId>
                <artifactId>maven-surefire-pluginartifactId>
                <configuration>
                    <skip>trueskip>
                configuration>
            plugin>

            <plugin>
                <groupId>org.apache.maven.pluginsgroupId>
                <artifactId>maven-compiler-pluginartifactId>
                <version>2.5.1version>
                <configuration>
                    <source>1.6source>
                    <target>1.6target>
                    <encoding>UTF-8encoding>
                configuration>
            plugin>
        plugins>
        <resources>
            <resource>
                <directory>src/main/resourcesdirectory>
                <filtering>truefiltering>
            resource>
            <resource>
                <directory>src/main/javadirectory>
                <includes>
                    <include>**/*.xmlinclude>
                    <include>**/*.propertiesinclude>
                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>devid>
            <activation>
                <activeByDefault>trueactiveByDefault>
            activation>
            <build>
                <finalName>cnzz1finalName>
                <filters>
                    <filter>profile-dev.propertiesfilter>
                filters>
                <pluginManagement>
                    <plugins>
                        <plugin>
                            <groupId>org.apache.tomcat.mavengroupId>
                            <artifactId>tomcat7-maven-pluginartifactId>
                            <version>2.2version>
                            <configuration>
                                <path>/cnzzdatapath>
                                <port>8888port>
                                <uriEncoding>UTF-8uriEncoding>
                                <url>http://localhost:8888/manager/texturl>
                                <server>tomcat8server>
                                
                                <contextReloadable>truecontextReloadable>
                            configuration>
                        plugin>
                    plugins>
                pluginManagement>
            build>
        profile>
        <profile>
            <id>prodid>
            <build>
                <finalName>cnzzdata.prodfinalName>
                <filters>
                    <filter>profile-prod.propertiesfilter>
                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
更详细的可以看这里：
http://blog.csdn.net/luckyzhoustar/article/details/50411962

七.pluginRepositories插件仓库
看看我们讲的第三部分“私有仓库repositories”，这里也有一个Repositories，不过是plugin的Repositories，也就是插件的私有仓库
字段同repositories类似，不再赘述

    <pluginRepositories>
        <pluginRepository>
            <id>apache.snapshotsid>
            <name>Apache Snapshotsname>
            <url>http://repository.apache.org/content/groups/snapshots-group/url>
            <releases>
                <enabled>falseenabled>
            releases>
            <snapshots>
                <enabled>trueenabled>
            snapshots>
        pluginRepository>
    pluginRepositories>

八.properties定义常量
这部分比较简单，定义了一些常量，用来避免一些重复的东西：

    
        3.2.2.RELEASE
        .security.version>3.2.3.RELEASE.security.version>
        .version>3.2.11.RELEASE.version>
        .version>1.7.5.version>
    

在我们上面的dependency部分，对应的是这样写的：

        <dependency>
            <groupId>org.springframeworkgroupId>
            <artifactId>spring-contextartifactId>
            <version>${springframework-version}version>
        dependency>
        <dependency>
            <groupId>org.springframeworkgroupId>
            <artifactId>spring-webmvcartifactId>
            <version>${springframework-version}version>
        dependency>
        <dependency>
            <groupId>org.springframeworkgroupId>
            <artifactId>spring-ormartifactId>
            <version>${springframework-version}version>
        dependency>
        <dependency>
            <groupId>org.springframeworkgroupId>
            <artifactId>spring-testartifactId>
            <version>${springframework-version}version>
            <scope>testscope>
        dependency>

可以看到，这样就不用定义多次，避免升级spring版本的时候漏改。