Maven可以通过site生成项目的帮助文档,并且格式为html,那么可以通过site-deploy把文档部署到远端,部署方式支持HTTP/FTP/SCM/WebDAV等。

更多部署方案,​

下面将展示使用Tomcat的WebDAV功能实现文档的部署,实现之前需要确保Tomcat已经开启此功能(开启教程:):

1、配置POM



<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.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.jsoft.test</groupId>
<artifactId>testproject</artifactId>
<packaging>war</packaging>
<version>0.1-SNAPSHOT</version>
<name>testproject Maven Webapp</name>
<url>http://maven.apache.org</url>
<distributionManagement>
<site>
<id>tomcatserver</id>
<url>dav:http://127.0.0.1:8080/webdav/</url>
</site>
</distributionManagement>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<finalName>testproject</finalName>
<extensions>
<extension>
<groupId>org.apache.maven.wagon</groupId>
<artifactId>wagon-webdav-jackrabbit</artifactId>
<version>1.0-beta-7</version>
</extension>
</extensions>
</build>
</project>


提示:WebDAV部署插件为wagon-webdav-jackrabbit,实质上为扩展。配置<distributionManagement>节点,增加<id>和<url>节点,其中<id>节点上的名称需要与%M2_HOME%\conf\settings.xml的<server>节点对应,<url>为配置好webdav的目录,并且前面带上dav:前缀,表示是以WebDAV协议进行访问。

2、配置%M2_HOME%\conf\settings.xml,增加<server>节点,内容如下:



<servers>
...
<server>
<id>tomcatserver</id>
<username>root</username>
<password>root</password>
</server>
...
</servers>


3、部署



mvn site:deploy


Maven使用site-deploy(site:deploy)部署通过site生成的文档(Tomcat-WebDAV)_apache

完成后打开站点http://127.0.0.1:8080/webdav测试:

Maven使用site-deploy(site:deploy)部署通过site生成的文档(Tomcat-WebDAV)_maven_02

成功部署。

 

测试工程:​​https://github.com/easonjim/5_java_example/tree/master/maventest/test7/testproject​