本文包括两个Maven管理的示例应用——Warsaw和Global。Warsaw是进行了全面配置的Web应用,带有两个简单的Web页面。Global依赖于Warsaw项目,引入了一个服务和几个新的Web页面,还修改了Warsaw组件的拷贝。这两个Web应用都打包为WAR文件,并进行了配置,能在Jetty或其它Servlet容器中运行。在命令行运行mvn jetty:run-war命令即可轻松启动这两个应用。
Maven的WAR插件
Java编写的简单Web应用可发布为一个WAR文件,里面包含编译好的类、JSP和XML文件、静态网页及其他资源。使用maven-war-plugin插件可以完成几个WAR文件的合并。我们需要做的只是在应用的pom.xml文件中为WAR文件设置打包属性,并设置对另一个WAR文件的依赖。本文使用了两个示例应用——主应用Warsaw和依赖于Warsaw项目的Global。清单1和清单2分别显示了Warsaw项目和Global项目中pom.xml的基本版本。
清单1:Warsaw项目中Maven pom.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.0http://maven.apache.org/maven-v4_0_0.xsd" ><modelVersion> 4.0.0 </modelVersion><groupId> com.example.modular </groupId><artifactId> warsaw </artifactId><packaging> war </packaging><version> 1.0 </version><name> Modular Wicket Warsaw Project </name><dependencies><!-- Warsaw项目的依赖配置 --></dependencies></project>
清单2:Global项目中Maven pom.xml文件的基本版本,Global依赖于Warsaw。
<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.0http://maven.apache.org/maven-v4_0_0.xsd" ><modelVersion> 4.0.0 </modelVersion>
<groupId> com.example.modular </groupId><artifactId> global </artifactId><packaging> war </packaging><version> 1.0 </version><name> Modular Wicket Global Project </name><dependencies><dependency><groupId> com.example.modular </groupId><artifactId> warsaw </artifactId><version> 1.0 </version><type> war </type></dependency></dependencies></project>
两个项目编译、打包之后,生成的WAR文件(warsaw-1.0.war和global-1.0.war)几乎是相同的,尽管Global项目还没有任何类和资源。重要的是,两个WAR归档文件中都有全部的依赖库和配置。
根据Java规范,classpath不能指定WAR文件。这就意味着在编译时,Global项目无法访问Warsaw项目中定义的类,所以在Global项目中,我们不能像常规类组件那样扩展或使用Warsaw定义的类。要解决这一问题,我们必须重新设置maven-war-plugin的一项缺省配置,该设置如下面的清单3所示。
清单3:将以下配置添加到Warsaw项目的Maven pom.xml文件中。
<build><plugins><plugin><artifactId> maven-war-plugin </artifactId><configuration><attachClasses> true </attachClasses></configuration></plugin><plugins><build>
启用attachClasses选项可以把JAR文件(warsaw-1.0-classes.jar)和标准的WAR文件同时安装到Maven仓库中。要访问该JAR文件,我们需要像清单4所示的那样修改Global项目的依赖列表。
清单4:Global项目的Maven pom.xml文件中,修改后的依赖设置。
<dependencies><dependency><groupId> com.example.modular </groupId><artifactId> warsaw </artifactId><version> 1.0 </version><type> war </type></dependency><dependency><groupId> com.example.modular </groupId><artifactId> warsaw </artifactId><version> 1.0 </version><type> jar </type><classifier> classes </classifier><scope> provided </scope></dependency></dependencies>
可以看到,Global项目用Warsaw WAR创建最终的Web归档文件,出于编译需要,还使用了Warsaw的类(打包在JAR里)。我们将属性classifier设置为classes,以此定义该从仓库中选择哪个工件。将scope设置为provided,则是告诉Maven只在编译时需要该工件,运行时则从其他地方获得。“其他地方”当然就是指Warsaw项目的WAR工件,WAR插件会将WAR和JAR合并在一起。现在已经正确配置了依赖关系,那我们就开始构建应用。
摘抄自:作者 Krzysztof ?migielski ,译者 王丽娟