Maven site:deploy 站点部署

    Maven site生成的站点文件，可以直接部署到容器中，以下以Tomcat为例。
    1> tomcat默认支持WebDav协议，支持热部署。
    首先在Tomcat的webapps目录下生成一个site目录，然后在site目录里生成WEB-INF目录，结构如下：
    apache-tomcat-7.0.47
     |--webapps
        |--site
           |--WEB-INF
              |--web.xml
      web.xml内容如下：
<servlet> 
<servlet-name>webdav</servlet-name> 
<servlet-class>org.apache.catalina.servlets.WebdavServlet</servlet-class> 
<init-param> 
    <param-name>debug</param-name> 
    <param-value>0</param-value> 
    </init-param> 
<init-param> 
    <param-name>listings</param-name> 
    <param-value>true</param-value> 
</init-param> 
<init-param> 
    <param-name>readonly</param-name> 
    <param-value>false</param-value> 
</init-param> 
<load-on-startup>1</load-on-startup> 
</servlet> 
 
<servlet-mapping> 
<servlet-name>webdav</servlet-name> 
<url-pattern>/*</url-pattern> 
</servlet-mapping> 

   <!-- Define a Security Constraint on this Application -->
  <!-- NOTE:  None of these roles are present in the default users file -->
  <security-constraint>
    <web-resource-collection>
      <web-resource-name>Site</web-resource-name>
      <url-pattern>/*</url-pattern>
    </web-resource-collection>
    <auth-constraint>
       <role-name>site</role-name>
    </auth-constraint>
  </security-constraint>

  <!-- Define the Login Configuration for this Application -->
  <login-config>
    <auth-method>BASIC</auth-method>
    <realm-name>Maven Site Deploy</realm-name>
  </login-config>

  <!-- Security roles referenced by this web application -->
  <security-role>
    <description>
      The role that is required to access to site pages
    </description>
    <role-name>site</role-name>
  </security-role>
</web-app> 

    <security-role>、<login-config>、<security-constraint>是给发布站点增加访问权限设置，以上设置为只有角色为site的用户才能访问发布站点。
    site角色用户，在tomcat根目录下的conf/tomcat-users.xml增加以下设置：
<role rolename="site" />
<user username="admin" password="xxxxxx" roles="site" />

    2> 在项目的pom.xml中增加以下设置：
    <!--设置site插件读取源文件、输出站点文件的编码格式为UTF-8 -->
    <properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    </properties>
   
    <reporting>
<plugins>
            <!--测试代码覆盖率报告插件 -->
    <plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>cobertura-maven-plugin</artifactId>
<version>2.6</version>
<configuration>
<aggregate>true</aggregate>
</configuration>
    </plugin>
            <!--javadoc报告插件 -->
    <plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.10.1</version>
    </plugin>
            <!--源代码在线查看插件 -->
    <plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jxr-plugin</artifactId>
<version>2.4</version>
<configuration>
    <aggregate>true</aggregate>
</configuration>
    </plugin>
            <!--代码规范检查报告插件 -->
    <plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-checkstyle-plugin</artifactId>
<version>2.13</version>
        <configuration>
<configLocation>config/maven_checks.xml</configLocation>
<goal>checkstyle-aggregate</goal>
</configuration>
    </plugin>
            <!--版本控制信息报告插件 -->
    <plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-changelog-plugin</artifactId>
<version>2.3</version>
    </plugin>
            <!--findbugs报告插件 -->
    <plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>findbugs-maven-plugin</artifactId>
<version>3.0.0</version>
    </plugin>
</plugins>
    </reporting>

    <!--发布站点URL配置 -->
    <distributionManagement>
<site>
      <id>site</id>
    <url>dav:http://localhost:8080/site</url>
</site>
    </distributionManagement>

    <build>
<plugins>
                <!-- 配置site插件使用中文界面 -->
        <plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-site-plugin</artifactId>
<version>3.4</version>
<configuration>
<locales>zh_CN</locales>
</configuration>
</plugin>
        </plugins
<extensions>
                <!-- 配置site插件deploy时，部署到webdav协议的站点时，需要用到的                  
                     webdav协议识别插件 -->
<extension>
<groupId>org.apache.maven.wagon</groupId>
<artifactId>wagon-webdav-jackrabbit</artifactId>
<version>2.7</version>
</extension>
</extensions>
    </build>

    3> 因为site发布的站点设置了访问控制权限，因此需要在用户的settings.xml文件中设置访问权限：
       <server> 
         <!-- id必须和pom.xml中的发布站点id保持一致 -->
         <id>site</id> 
         <username>admin</username> 
         <password>xxxxxx</password> 
       </server> 

    至此，maven site:deploy 站点部署配置完成。maven确实很方便，也做了很多项目信息的整合，确实好用，虽然入门难了点。
    enjoy maven, enjoy life...