Maven 工程规范

SuperPom继承

所有工程需直接或间接继承 SuperPom

<parent>
<artifactId>qunar-supom</artifactId>
<groupId>qunar.common</groupId>
<version>1.3.2</version>
</parent>

避免使用默认profile,不要出现以下代码

<activation>
<activeByDefault>true</activeByDefault>
</activation>

WAR工程忽略deploy

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-deploy-plugin</artifactId>
<configuration>
<skip>true</skip>
</configuration>
</plugin>

重复类检查

1. 增加超级pom指向

<parent>
<groupId>qunar.common</groupId>
<artifactId>qunar-supom-generic</artifactId>
<version>1.3.2</version>
</parent>

2. 运行命令查看重复类

mvn enforcer:enforce

3. 常见重复类排除

junit :jmockit 冲突问题: 请将 junit 换成 junit-dep
commons-beanutils & commons-collections 冲突问题: 去掉commons-beanutils版本号
jcl-over-slf4j & commons-logging 冲突: 删掉 commons-logging


版本号管理

所有依赖的版本号应使用dependencyManagement 显示管理. dependency中不能包含版本号

<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.qunar.rpc.demo</groupId>
<artifactId>rpc-api</artifactId>
<version>0.0.1-SNAPSHOT</version>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>com.qunar.rpc.demo</groupId>
<artifactId>rpc-api</artifactId>
</dependency>
</dependency>

Scope定义

应明确定义除了compile之外的scope. 尤其是test. 作用域参考下表

scope	编译	测试	运行	举例
compile	Y	Y	Y	spring-core
test	-	Y	-	JUnit
provided	Y	Y	-	servlet-api
runtime	-	Y	Y	JDBC驱动
system	Y	Y	-	本地JNI相关,禁止使用

解决包冲突问题,使用搜索引擎

http://mvnrepository.com/

Jar 禁止包含工程配置文件

默认的屏蔽的文件有: *.xml, *.properties

Resource 继承与重载

1. 配置文件中各环境差异的放在profile中, 否则放在resource里.

2. 建议使用Spring的变量替换 , 禁用maven替换.

请慎用 combine.self="override"

DupplicateClass 解决汇总

Found in:
org.slf4j:slf4j-log4j12:jar:1.6.1:compile
org.slf4j:slf4j-jdk14:jar:1.6.1:compile
Duplicate classes:
org/slf4j/impl/StaticMarkerBinder.class
org/slf4j/impl/StaticLoggerBinder.class
org/slf4j/impl/StaticMDCBinder.class

解决方案 : 删掉 slf4j-jdk14:jar

原因: 这是分别两个slf4j的实现, 按标准选择 log4j实现.

Found in:
commons-beanutils:commons-beanutils:jar:1.8.2:compile
commons-beanutils:commons-beanutils-core:jar:1.7.0:compile
Duplicate classes:
org/apache/commons/beanutils/locale/LocaleBeanUtilsBean.class
org/apache/commons/beanutils/locale/converters/DoubleLocaleConverter.class
org/apache/commons/beanutils/locale/converters/DecimalLocaleConverter.class
org/apache/commons/beanutils/converters/ShortConverter.class

解决方案 : 删掉 commons-beanutils-core:jar, 并且采用beanutils的继承版本号.

原因: commons-beanutils-core:jar 是个有问题的包, 只删除了一部分外部依赖, 并没有彻底删掉外部包. 所以, 使用我们打过补丁的beanutils.