使用原型的新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可能没有这样的问题。