- 技术人生
- Maven2 pox.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/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <!-- groupId: groupId:项目或者组织的唯一标志，并且配置时生成的路径也是由此生成 --> <groupId>asia.qintianjie</groupId> <artifactId>qintianjie-maven2</artifactId> <!-- packaging: 打包的机制，如pom, jar, maven-plugin, ejb, war, ear, rar, par --> <packaging>jar</packaging> <version>1.0-SNAPSHOT</version> <!-- 项目的名称， Maven 产生的文档用 --> <name>qintianjie-maven</name> <url>http://www.qintianjie.asia</url> <!-- 项目的描述, Maven 产生的文档用 --> <description>A maven project to study maven.</description> <!-- 开发者信息 --> <developers> <developer> <id>Qintj</id> <name>Qin Tianjie</name> <email>qininin@163.com</email> <roles> <role>Project Manager</role> <role>Architect</role> </roles> <organization>qintianjie</organization> <organizationUrl>http://www.qintianjie.asia</organizationUrl> <properties> <dept>No</dept> </properties> <timezone>-5</timezone> </developer> </developers> <!-- 类似 developers --> <contributors></contributors> <!-- 本项目相关 mail list, 用于订阅等信息 --> <mailingLists> <mailingList> <name>Qin Tianjie</name> <!-- Link mail --> <post>qininin@163.com</post> <!-- mail for subscribe the project --> <subscribe>qininin@163.com</subscribe> <!-- mail for unsubscribe the project --> <unsubscribe>qininin@163.com</unsubscribe> <archive> http://mail-archives.qintianjie.com/qintianjie/dev/ </archive> </mailingList> </mailingLists> <!-- 项目的问题管理系统(Bugzilla, Jira, Scarab,或任何你喜欢的问题管理系统)的名称和URL，本例为 jira --> <issueManagement> <system>jira</system> <url>http://jira.qintianjie.asia</url> </issueManagement> <!-- organization information --> <organization> <name>qintianjie</name> <url>http://www.qintianjie.asia</url> </organization> <!-- License --> <licenses> <license> <name>Apache 2</name> <url>http://www.qintianjie.asiz/LICENSE-2.0.txt</url> <distribution>repo</distribution> <comments>A business-friendly OSS license</comments> </license> </licenses> <!-- scm(software configuration management)标签允许你配置你的代码库，为Maven web站点和其它插件使用。 - 如果你正在使用CVS或Subversion，source repository页面同样能给如何使用代码库的详细的、工具相关的指令。 --> <scm> <!-- 项目在 svn 上对应的资源 --> <connection> scm:svn:http://svn.qintianjie.asia/maven/qintianjie/qintianjie-maven2-trunk(dao-trunk) </connection> <developerConnection> scm:svn:http://svn.qintianjie.asia/maven/qintianjie/dao-trunk </developerConnection> <url>http://svn.qintianjie.asia</url> </scm> <!-- 用于配置分发管理，配置相应的产品发布信息,主要用于发布，在执行mvn deploy后表示要发布的位置 --> <distributionManagement> <!-- 配置到文件系统 --> <repository> <id>qintianjie-maven2</id> <name>qintianjie maven2</name> <url>file://${basedir}/target/deploy</url> </repository> <!-- 使用ssh2配置 --> <snapshotRepository> <id>qintianjie-maven2</id> <name>Tqintianjie-maven2 Snapshot Repository</name> <url>scp://svn.qintianjie.asia:/usr/local/maven-snapshot</url> </snapshotRepository> <!-- 使用ssh2配置 --> <site> <id>qintianjie-site</id> <name>business api website</name> <url> scp://svn.qintianjie.asia:/var/www/localhost/qintianjie-web </url> </site> </distributionManagement> <!-- 依赖关系 --> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <!-- scope 说明 - compile ：默认范围，用于编译 - provided：类似于编译，但支持你期待jdk或者容器提供，类似于classpath - runtime: 在执行时，需要使用 - test: 用于test任务时使用 - system: 需要外在提供相应得元素。通过systemPath来取得 - systemPath: 仅用于范围为system。提供相应的路径 - optional: 标注可选，当项目自身也是依赖时。用于连续依赖时使用 --> <scope>test</scope> <!-- - systemPath: 仅用于范围为system。提供相应的路径 - optional: 标注可选，当项目自身也是依赖时。用于连续依赖时使用 --> <!-- <type>jar</type> <optional>true</optional> --> </dependency> <!-- - 外在告诉maven你只包括指定的项目，不包括相关的依赖。此因素主要用于解决版本冲突问题 - 如下依赖表示 项目acegi-security依赖 org.springframework.XXX 项目，但我们不需要引用这些项目 --> <dependency> <groupId>org.acegisecurity</groupId> <artifactId>acegi-security</artifactId> <version>1.0.5</version> <scope>runtime</scope> <exclusions> <exclusion> <artifactId>spring-core</artifactId> <groupId>org.springframework</groupId> </exclusion> <exclusion> <artifactId>spring-support</artifactId> <groupId>org.springframework</groupId> </exclusion> <exclusion> <artifactId>commons-logging</artifactId> <groupId>commons-logging</groupId> </exclusion> <exclusion> <artifactId>spring-jdbc</artifactId> <groupId>org.springframework</groupId> </exclusion> <exclusion> <artifactId>spring-remoting</artifactId> <groupId>org.springframework</groupId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring</artifactId> <version>2.5.1</version> <scope>runtime</scope> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>2.5.1</version> <scope>runtime</scope> </dependency> <dependency> <groupId>postgresql</groupId> <artifactId>postgresql</artifactId> <version>8.2-504.jdbc4</version> <scope>runtime</scope> </dependency> <dependency> <groupId>com.oracle</groupId> <artifactId>ojdbc6</artifactId> <version>11.1.0.6</version> <scope>runtime</scope> </dependency> </dependencies> <!-- - maven proxy, 本地仓库，替代 maven.apache.org 网站 jar 列表，用户下载时，首先寻找该站点 - 如资源找到，则下载。否则才去 jar 列表网站。对多人团队，可节省下载速度和个人存储空间。 --> <repositories> <repository> <id>qintianjie-repository-proxy</id> <name>qintianjie-repository-proxy</name> <url>http://192.168.1.169:9999/repository/</url> <layout>default</layout> </repository> </repositories> <!--接 part 1 部分--> <!-- ####################################################### ## build 主要用于编译设置，包括两个主要的元素，build和report ########################################################## --> <build> <!-- finalName: 生成最后的文件的样式 qintianjie-maven-1.0-SNAPSHOP.jar --> <finalName>qintianjie-maven2</finalName> <!-- defaultGoal: 定义默认的目标或者阶段。如compile, package, install等， - 当cmd中执行 mvn 时， 默认为 mvn <defaultGoal>.value，如： mvn package --> <defaultGoal>package</defaultGoal> <!-- directory: 编译输出的目录,该编译目录为 qintianjie-maven.jar --> <directory>d:/maventest</directory> <!-- qintianjie-maven project 目录下有一个 qintianjie.properties 文件 --> <filters> <!-- filter>qintianjie.properties</filter --> <filter> ${basedir}/src/main/plexus/qintianjie.properties </filter> </filters> <!-- 指定资源位置，默认为 src/main/resources 目录 --> <resources> <resource> <!-- 编译后在 classes 中位置，本文为 classes/META-INF/plexus --> <targetPath>META-INF/plexus</targetPath> <!-- 资源位置 --> <directory>${basedir}/src/main/plexus</directory> <!-- - filtering: 是否替换资源中的属性placehold, 为 true 则替换，对合适的任何文件 *.xml, *.jsp 等过滤 - 例如： 假设 qintianjie.properties 内容为: name=Qin Tianjie - configuration.xml 内容为: My name is ${name}; - 则 编译后 configuration.xml 内容为： My name is Qin Tianjie; --> <filtering>true</filtering> <!-- 包含的资源, 注意最后一个 include--> <includes> <include>configuration.xml</include> <include>configuration2.xml</include> <include>*.xml</include> <include>*.*</include> <!-- 包含本目录和所有子目录文件，很重要，否则只是当前目录文件 --> <include>**/**</include> </includes> <!-- 不包含 *.properties 形式文件 --> <excludes> <exclude>**/*.properties</exclude> <!-- <exclude>**/*.properties</exclude> --> </excludes> </resource> <!-- 系统默认资源 --> <resource> <directory>${basedir}/src/main/resources</directory> <filtering>true</filtering> </resource> </resources> <!-- Java 源码位置 --> <sourceDirectory>${basedir}/src/main/java</sourceDirectory> <!-- 一些其他目录的设置 --> <scriptSourceDirectory> ${basedir}/src/main/scripts </scriptSourceDirectory> <testSourceDirectory> ${basedir}/src/test/java </testSourceDirectory> <outputDirectory>${basedir}/target/classes</outputDirectory> <testOutputDirectory> ${basedir}/target/test-classes </testOutputDirectory> <!-- 配置 JDK 版本和字符编码 --> <plugins> <!-- 字符编码 --> <plugin> <artifactId>maven-site-plugin</artifactId> <!-- configuration: 指定插件配置 --> <configuration> <outputEncoding>UTF-8</outputEncoding> <inputEncoding>UTF-8</inputEncoding> </configuration> </plugin> <!-- JDK 版本 --> <plugin> <artifactId>maven-compiler-plugin</artifactId> <configuration> <source>1.6</source> <target>1.6</target> <encoding>utf-8</encoding> </configuration> </plugin> </plugins> </build> <!-- 用于在site阶段输出报表。特定的maven 插件能输出相应的定制和配置报表。 - 参考: http://maven.apache.org/plugins/ --> <reporting> <!-- 产生文档的位置 --> <outputDirectory>${basedir}/target/site/maven</outputDirectory> <plugins> <!-- maven project 报表插件 --> <plugin> <artifactId> maven-project-info-reports-plugin </artifactId> <configuration> <!-- 页面编码，设置与你匹配的编码 --> <encoding>GBK</encoding> <charset>GBK</charset> <!-- outputDirectory>${basedir}/target/site/maven</outputDirectory> <inputEncoding>utf-8</inputEncoding> <outputEncoding>utf-8</outputEncoding --> </configuration> <!-- reportSets> <reportSet> <id>sunlink</id> <reports> <report>javadoc</report> </reports> <inherited>true</inherited> <configuration> <links> <link>http://java.sun.com/j2se/1.5.0/docs/api/</link> </links> </configuration> </reportSet> </reportSets --> </plugin> <!-- Java API 文档 --> <plugin> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <encoding>GBK</encoding> <charset>GBK</charset> </configuration> </plugin> <!-- 生成源代码的一个有索引和交叉查考的HTML版本 --> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>jxr-maven-plugin</artifactId> <configuration> <encoding>GBK</encoding> <charset>GBK</charset> </configuration> </plugin> <!-- Maven在build构建过程中完全整合了单元测试—默认情况下, 每一次构建都会运行所有的单元测试。 - surefire插件运行所有的单元测试，然后生成一个详细报表 --> <plugin> <artifactId>maven-surefire-report-plugin</artifactId> <configuration> <encoding>GBK</encoding> <charset>GBK</charset> </configuration> </plugin> <!-- 生成测试覆盖报表,测试覆盖率可以很好的显示你的单元测试的质量如何。 - 它简单的告诉你有多少代码被单元测试运行到了，而这能给你检测测试质量的好主意。 --> <plugin> <artifactId>maven-clover-plugin</artifactId> </plugin> <!-- 自动代码分析有助于提高代码质量和鼓励良好的编码习惯。Checkstyle运行多而广的 - 测试以检查是否符合强制的代码标准和最佳实践。PMD更多的专注于语义上的错误和潜在的bug。 --> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-pmd-plugin</artifactId> <configuration> <!-- JKD 版本 --> <targetjdk>1.6</targetjdk> <rulesets> <ruleset>/rulesets/basic.xml</ruleset> <ruleset>/rulesets/controversial.xml</ruleset> </rulesets> <format>xml</format> <!-- 是否显示超链接 --> <linkXref>true</linkXref> <sourceEncoding>utf-8</sourceEncoding> <minimumTokens>100</minimumTokens> </configuration> </plugin> <!-- - changes-maven-plugin插件使用一种特别的XML文件(src/changes/changes.xml) - 来记录每次发布的版本和更改。 文件格式见最后： --> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>changes-maven-plugin</artifactId> </plugin> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>changelog-maven-plugin</artifactId> </plugin> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>taglist-maven-plugin</artifactId> </plugin> </plugins> </reporting> </project> <!-- changes.xml <?xml version="1.0" encoding="ISO-8859-1"?> <document> <properties> <title>Project info</title> <author email="qininin@163.com">Duke Java</author> </properties> <body> <release version="current" description="Current work version"> <action dev="QinTianjie" type="add"> A new cool feature. </action> </release> <release version="1.0.1" date="2007-11-18" description="Release fix"> <action dev="QinTianjie" type="add"> Added a cool feature. </action> <action dev="QinTianjie" type="fix" issue="1254"> Fixed a nasty bug. </action> <action dev="QinTianjie" type="delete"> Removed a feature that nobody liked. </action> </release> </body> </document> -->
