Maven入门实战笔记09-Web应用

 

Web项目的目录结构

基于Java的Web应用，其标准的打包方式是WAR

一个典型的WAR文件有如下目录结构：

 一个WAR包下至少包含两个子目录：META-INF和WEB-INF。

前者包含了一些打包元数据；后者是WAR包的核心，

WEB-INF下必须包含一个Web资源表述文件web.xml，

它的子目录 classes包含所有该Web项目的类，

而另一个子目录lib则包含所有该Web项目的依赖JAR包

classes和lib目录都会在运行的时候被加入到Classpath中

 

用户必须为Web项目显式指定打包方式为war，如：

<artifactId>account-web</artifactId>
<packaging>war</packaging>
<name>Maven Account-Web Project</name>

 Web项目的类及资源文件：默认位置src/main/java和src/main/resources

 

测试类有测资源文件：默认位置src/test/java和src/test/resources

以上同一般JAR项目

不同：

Web项目还有一个Web资源目录，其默认位置是src/main/webapp

一个典型的Web项目的Maven目录结构如下：

 

 

注：finalName该元素用来标识项目生成的主构件的名称，该元素的默认值已在超级POM中设定，值为${project.artifactId}-${project.version}，如：account-web-1.0.0-SNAPSHOT.war显然，这样的名称不利于部署，我们需要配置更简洁的名字，如下：

<build>
	<finalName>account</finalName>
        ....
</build>

 

 

使用jetty-maven-plugin进行测试可以用单元测试覆盖的代码就不应该依赖于Web页面测试

页面测试应该仅限于页面的层次，如JSP、CSS、JavaScript的修改，

其它代码修改（如数据访问），请编写单元测试

 

传统的Web测试方法要求我们编译、测试、打包及部署，这往往会消耗数10秒至数分钟的时间，jetty-maven-plugin能够帮助我们节省时间，它能够周期性地检查项目内容，发现变更后自动更新到内置的Jetty Web容器中。

jetty-maven-plutin默认就很好地支持了Maven的项目目录结构，配置如下：

 

<plugin>
	<groupId>org.mortbay.jetty</groupId>
	<artifactId>jetty-maven-plugin</artifactId>
	<version>8.1.9.v20130131</version>
	<configuration>
		<scanIntervalSeconds>10</scanIntervalSeconds>
		<webAppConfig>
			<contextPath>/test</contextPath>
		</webAppConfig>
	</configuration>
</plugin>

 scanIntervalSeconds:表示该插件扫描项目变更的时间间隔，如果不配置，默认为0，表示不扫描，用户也就失去了自动化热部署的功能

webappConfig元素下的contextPath表示项目部署后的context path。这里值为/text那么用户就可以通过

http://hostname:port/text访问该应用

 

配置一下settings.xml

因为默认情况下，只有org.apache.maven.plugins和org.codehaus.mojo两个groupId下的插件才支持简化的命令行调用，即可以运行mvn help:system，但mvn jetty:run就不行了，因为maven-help-plugin的groupId是org.apache.maven.plugins，而jetty-maven-plugins的groupId是org.mortbay.jetty。为了能在命令行下直接运行mvn jetty:run，用户需要配置settings.xml如下：

<!-- 可以在命令行下直接运行mvn jetty:run -->
<pluginGroups>
	<pluginGroup>org.mortbay.jetty</pluginGroup>
</pluginGroups>

 

 

命令行下启动maven-jetty-plugin

 

mvn jetty:run

 jetty-maven-plugin会启动Jetty，并且默认监听本地的8080端口，并将当前项目部署到容器中，同时它还会根据用户配置扫描代码改动。

 

 

如果希望使用其他端口，可以添加jetty.port参数。如：

 

mvn jetty:run -Djetty.port=9999

可通过地址http://localhost:9999/test/测试应用了

 

停止用Ctrl+C

只要不是修改类名、方法名、新增加方法等较大操作，jetty-maven-plugin都能够扫描到变更并正确地将变化更新至Web容器中。

 

参考：jetty插件

 

 

使用Cargo实现自动化部署

Cargo通过cargo-maven2-plugin提供Maven集成，它几乎支持所有的Web容器，如Tomcat、JBoss、Jetty和Glassfish等。

jetty-maven-plugin与cargo-maven2-plugin的功能看起来很相似，但它们的目的不同，

前者主要用来帮助日常的快速开发和测试

后者主要服务于自动化部署

部署至本地Web容器

Cargo支持两种本地部署方式，分别为standalone模式和existing模式。

在standalone模式中，Cargo会从Web容器的安装目录复制一份配置到用户指定的目录，然后在此基础上部署应用，每次重新构建的时候，这个目录都会被清空，所有配置被重新生成。

在existing模式中，用户需要指定现有的Web容器配置目录，然后Cargo会直接使用这些配置并将应用部署到其对应的位置。

使用standalone模式部署应用至本地Web容器

<!-- 使用standalone模式部署应用至本地Web容器 -->
<plugin>
	<groupId>org.codehaus.cargo</groupId>
	<artifactId>cargo-maven2-plugin</artifactId>
	<version>1.3.3</version>
	<configuration>
		<container>
			<containerId>tomcat6</containerId>
			<home>D:\tools\web\tomcat6_0_26</home>
		</container>
		<configuration>
			<type>standalone</type>
			<home>${project.build.directory}/tomcat6x</home>
		</configuration>
	</configuration>
</plugin>

 cargo-maven2-plugin的groupId是org.codehaus.cargo，这不属于官方的两插件groupId，因此用户需要将其添加到settings.xml的pluginGroup元素中以方便命令行调用。

<!-- 可以在命令行下直接运行mvn jetty:run 和mvn cargo:start -->
<pluginGroups>
	<pluginGroup>org.mortbay.jetty</pluginGroup>
	<pluginGroup>org.codehaus.cargo</pluginGroup>
</pluginGroups>

 

configuration下的两个元素

 

type：表示部署的模式

home：表示复制窗口配置到什么位置，这里值为${project.build.directory}/tomcat6x，表示构建输出目录，即target/下的tomcat6x子目录。

container元素下的两个元素

containerId：表示容器的类型

home：表示容器的安装目录

基于该配置，Cargo会从D:\tools\web\tomcat6_0_26目录下复制配置到当前项目的target/tomcat6x/目录下

让Cargo启动Tomcat并部署应用，运行

mvn clean verify cargo:start

 默认情况下，Cargo会让Web容器监听8080端口。可以通过修改Cargo的cargo.servlet.port属性来改变这一配置

更改Cargo的Servlet监听端口：

<!-- 使用standalone模式部署应用至本地Web容器 -->
<plugin>
	<groupId>org.codehaus.cargo</groupId>
	<artifactId>cargo-maven2-plugin</artifactId>
	<version>1.3.3</version>
	<configuration>
		<container>
			<containerId>tomcat6x</containerId>
			<home>D:\tools\web\tomcat6_0_26</home>
		</container>
		<configuration>
			<type>standalone</type>
			<home>${project.build.directory}/tomcat6x</home>
			<properties>
				<cargo.servlet.port>8081</cargo.servlet.port>
			</properties>
		</configuration>
	</configuration>
</plugin>

 将应用直接部署到现有的Web容器下，需要配置Cargo使用existing模式

<!-- 使用standalone模式部署应用至本地Web容器
	configuration-type:standalone 
	configuration-home:${project.build.directory}/tomcat6x
-->
<!-- 使用existing模式部署应用至本地Web容器 
	configuration-type:existing
	configuration-home:D:\tools\web\tomcat6_0_26
-->
<plugin>
	<groupId>org.codehaus.cargo</groupId>
	<artifactId>cargo-maven2-plugin</artifactId>
	<version>1.3.3</version>
	<configuration>
		<container>
			<containerId>tomcat6x</containerId>
			<home>D:\tools\web\tomcat6_0_26</home>
		</container>
		<configuration>
			<type>existing</type>
			<home>D:\tools\web\tomcat6_0_26</home>
		</configuration>
	</configuration>
</plugin>

 

使用existing模式部署应用至本地Web容器 基于该配置运行 mvn cargo:start 之后，便能够在Tomcat的webapps子目录看到被部署的Maven项目了。

 

参考：cargo插件

 

部署至远程Web容器

部署应用至远程Web容器

<!-- 部署应用至远程Web容器 -->
<plugin>
	<groupId>org.codehaus.cargo</groupId>
	<artifactId>cargo-maven2-plugin</artifactId>
	<version>1.3.3</version>
	<configuration>
		<container>
			<containerId>tomcat6x</containerId>
			<type>remote</type>
		</container>
		<configuration>
			<type>runtime</type>
			<properties>
				<cargo.remote.username></cargo.remote.username>
				<cargo.remote.password></cargo.remote.password>
				<cargo.remote.manager.url>http://localhost:8080/manager</cargo.remote.manager.url>
			</properties>
		</configuration>
	</configuration>
</plugin>

 对于远程部署来说，

container元素的type子元素的值必须为remote,

默认使用installed,并寻找对应的容器安装目录或者安装包

configuration的子元素type的值为runtime，表示即不使用独立的容器配置，也不使用本地现有的容器配置，而是依赖一个已运行的窗口

properties：用来声明一些窗口热部署相关的配置。

例如：Tomcat6就需要提供用户名、密码和管理地址，

让Cargo部署应用

mvn cargo:redeploy

 如果容器中已经部署了当前应用，Cargo会先将其卸载，然后再重新部署

 

----------------------------------------------------------------------------------------------------------------------

@autor Free Coding http://ln-ydc.iteye.com/