使用原型的新Maven项目:为什么要在POM中复制javaee-endorsed-api.jar?

我使用Maven原型( webapp-javaee6 )来创建一个新的Java EE 6项目,但不明白为什么某些东西放在POM的build元素中。 具体来说,我不明白为什么将javaee-endorsed-api.jar复制到endorsed目录。 根据这个问题的答案,这是编译所需要的,但是当我删除build中的相关plugin元素时,我的项目编译得很好。

由于javax:javaee-web-api已经作为POM中的依赖项提供,这不能用于编译吗?

    org.apache.maven.plugins maven-compiler-plugin 2.3.2  1.6 1.6  ${endorsed.dir}     org.apache.maven.plugins maven-dependency-plugin 2.1   validate  copy   ${endorsed.dir} true   javax javaee-endorsed-api 6.0 jar         

它应该编译,因为还存在对此工件的依赖:

   javax javaee-web-api 6.0 provided   

Maven手册页介绍如下:

这很像compile,但表示您希望JDK或容器在运行时提供依赖性。 例如,在为Java Enterprise Edition构建Web应用程序时,您可以将Servlet API和相关Java EE API的依赖关系设置为提供的范围,因为Web容器提供了这些类。 此范围仅在编译和测试类路径中可用,并且不可传递。

因此,在我看来,复制此依赖项对编译没有影响。

但是,archetype的作者出于某种原因希望将Java EE 6 API包复制到endorsed目录。 如果您决定启动Jetty服务器并在“测试阶段”(例如使用JUnit)中进行一些测试,这可能会有所帮助。

如果您没有使用它 – 只需将其删除即可。

[通过查看webapp-javaee6原型的来源发现MARCHETYPES-35 ]

背景
JSR 250:Common Annotations中的包javax.annotation不仅存在于Java EE中 ,还存在于JDK中 。

使用的版本
JDK 6:通用注释1.0
Java EE 6:通用注释1.1
JDK 7:通用注释1.1
Java EE 7:通用注释1.2

问题
编译Java EE项目时,JDK中的注释优先于javaee-web-api jar中的注释。 当javaee-web-api中的注释定义了一个新元素时,编译器可能看不到它并因错误而失败。

例如
当Java EE 6项目使用@Resource(lookup = "...")并使用JDK 6编译时,它通常会失败。

Common Annotations 1.1 引入了新元素 Resource.lookup() 。 但通常编译器只会看到JDK 6中的Resource注释,它使用没有此元素的 Common Annotations 1.0。


在描述时使用编译器参数。 强制编译器使用正确版本的注释。

JAVA EE 7
据我了解Java EE 7的Common Annotations 1.2的更改日志,注释中没有新元素。 所以在实践中,Java EE 7和JDK 7可能没有这样的问题。