You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by bu...@apache.org on 2012/03/02 00:09:05 UTC
svn commit: r806981 [34/46] - in /websites/staging/maventest/trunk/content:
./ ant/ background/ css/ developers/ developers/conventions/
developers/release/ developers/website/ docs/ docs/2.0.1/ docs/2.0.10/
docs/2.0.11/ docs/2.0.2/ docs/2.0.3/ docs/2....
Added: websites/staging/maventest/trunk/content/guides/plugin/guide-java-plugin-development.html
==============================================================================
--- websites/staging/maventest/trunk/content/guides/plugin/guide-java-plugin-development.html (added)
+++ websites/staging/maventest/trunk/content/guides/plugin/guide-java-plugin-development.html Thu Mar 1 23:08:58 2012
@@ -0,0 +1,442 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Mar 1, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Guide to Developing Java Plugins</title>
+ <style type="text/css" media="all">
+ @import url("../../css/maven-base.css");
+ @import url("../../css/maven-theme.css");
+ @import url("../../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Bob Allison
+Vincent Siveton" />
+ <meta name="Date-Creation-yyyymmdd" content="20090826" />
+ <meta name="Date-Revision-yyyymmdd" content="20120301" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../.././" id="bannerLeft">
+ <img src="../../images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="../../images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="../../index.html">Maven</a>
+ >
+ Guide to Developing Java Plugins
+ </div>
+ <div class="xright">
+ Last Published: 2012-03-01
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Main</h5>
+ <ul>
+ <li class="none">
+ <a href="../../index.html">Welcome</a>
+ </li>
+ </ul>
+ <h5>Get Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="../../download.html">Download</a>
+ </li>
+ <li class="none">
+ <a href="../../docs/3.0.4/release-notes.html">Release Notes (3.0.4)</a>
+ </li>
+ <li class="none">
+ <a href="../../docs/2.2.1/release-notes.html">Release Notes (2.2.1)</a>
+ </li>
+ <li class="none">
+ <a href="../../docs/2.0.11/release-notes.html">Release Notes (2.0.11)</a>
+ </li>
+ <li class="none">
+ <a href="../../license.html">License</a>
+ </li>
+ </ul>
+ <h5>IDE Integration</h5>
+ <ul>
+ <li class="none">
+ <a href="../../eclipse-plugin.html">Eclipse</a>
+ </li>
+ <li class="none">
+ <a href="../../netbeans-module.html">NetBeans</a>
+ </li>
+ </ul>
+ <h5>About Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="../../what-is-maven.html">What is Maven?</a>
+ </li>
+ <li class="none">
+ <a href="../../maven-features.html">Features</a>
+ </li>
+ <li class="none">
+ <a href="../../general.html">FAQ (official)</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/FAQs-1" class="externalLink">FAQ (unofficial)</a>
+ </li>
+ <li class="none">
+ <a href="../../powered-by-m2.html">Powered By</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li class="none">
+ <a href="../../plugins/index.html">Maven Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../guides/index.html">Index (category)</a>
+ </li>
+ <li class="none">
+ <a href="../../run-maven/index.html">Running Maven</a>
+ </li>
+ <li class="collapsed">
+ <a href="../../users/index.html">User Centre</a>
+ </li>
+ <li class="expanded">
+ <a href="../../plugin-developers/index.html">Plugin Developer Centre</a>
+ <ul>
+ <li class="none">
+ <strong>Your First Mojo</strong>
+ </li>
+ <li class="none">
+ <a href="../../developers/mojo-api-specification.html">Mojo API</a>
+ </li>
+ <li class="none">
+ <a href="../../ref/current/index.html">Maven API</a>
+ </li>
+ </ul>
+ </li>
+ <li class="none">
+ <a href="../../repository/index.html">Maven Repository Centre</a>
+ </li>
+ <li class="none">
+ <a href="../../developers/index.html">Maven Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="../../articles.html">Books and Resources</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/Home" class="externalLink">Wiki</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="../../community.html">Community Overview</a>
+ </li>
+ <li class="none">
+ <a href="../../guides/development/guide-helping.html">How to Contribute</a>
+ </li>
+ <li class="none">
+ <a href="../../guides/mini/guide-maven-evangelism.html">Maven Repository</a>
+ </li>
+ <li class="none">
+ <a href="../../users/getting-help.html">Getting Help</a>
+ </li>
+ <li class="none">
+ <a href="../../issue-tracking.html">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="../../source-repository.html">Source Repository</a>
+ </li>
+ <li class="none">
+ <a href="../../team-list.html">The Maven Team</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../../project-info.html">Project Information</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../../index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../../plugins/index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="../../images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements. See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership. The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License. You may obtain a copy of the License at --><!-- --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!-- --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied. See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><!-- NOTE: For help with the syntax of this file, see: --><!-- http://maven.apache.org/doxia/referen
ces/apt-format.html --><div class="section"><h2>Introduction<a name="Introduction"></a></h2><p>This guide is intended to assist users in developing Java plugins for Maven 2.0.</p><div class="section"><h3>Your First Plugin<a name="Your_First_Plugin"></a></h3><p>In this section we will build a simple plugin which takes no parameters and simply displays a message on the screen when run. Along the way, we will cover the basics of setting up a project to create a plugin, the minimal contents of a Java mojo, and a couple ways to execute the mojo.</p><div class="section"><h4>Your First Mojo<a name="Your_First_Mojo"></a></h4><p>At its simplest, a Java mojo consists simply of a single class. There is no requirement for multiple classes like EJBs, although a plugin which contains a number of similar mojos is likely to use an abstract superclass for the mojos to consolidate code common to all mojos.</p><p>When processing the source tree to find mojos, the class <tt>org.apache.maven.too
ls.plugin.extractor.java.JavaMojoDescriptorExtractor</tt> looks for classes with a "<tt>goal</tt>" annotation on the class. Any class with this annotation are included in the plugin configuration file.</p><div class="section"><h5>A Simple Mojo<a name="A_Simple_Mojo"></a></h5><p>Listed below is a simple mojo class which has no parameters. This is about as simple as a mojo can be. After the listing is a description of the various parts of the source.</p><div class="source"><pre>package sample.plugin;
+
+import org.apache.maven.plugin.AbstractMojo;
+import org.apache.maven.plugin.MojoExecutionException;
+
+/**
+ * Says "Hi" to the user.
+ * @goal sayhi
+ */
+public class GreetingMojo extends AbstractMojo
+{
+ public void execute() throws MojoExecutionException
+ {
+ getLog().info("Hello, world.");
+ }
+}</pre></div><ul><li>The class <tt>org.apache.maven.plugin.AbstractMojo</tt> provides most of the infrastructure required to implement a mojo except for the <tt>execute</tt> method.</li><li>The comment line starting with "<tt>@goal</tt>" is an example of an annotation. This annotation is required, but there are a number of annotations which can be used to control how and when the mojo is executed.</li><li>The <tt>execute</tt> method can throw two exceptions:<ul><li><tt>org.apache.maven.plugin.MojoExecutionException</tt> if an unexpected problem occurs. Throwing this exception causes a "BUILD ERROR" message to be displayed.</li><li><tt>org.apache.maven.plugin.MojoFailureException</tt> if an expected problem (such as a compilation failure) occurs. Throwing this exception causes a "BUILD FAILURE" message to be displayed.</li></ul></li><li>The <tt>getLog</tt> method (defined in <tt>AbstractMojo</tt>) returns a log4j-like logger object which allows p
lugins to create messages at levels of "debug", "info", "warn", and "error". This logger is the accepted means to display information to the user. Please have a look at the section <a href="../../plugin-developers/common-bugs.html#Retrieving_the_Mojo_Logger">Retrieving the Mojo Logger</a> for a hint on its proper usage.</li></ul><p>All Mojo annotations are described by the <a href="../../developers/mojo-api-specification.html#The_Descriptor_and_Annotations">Mojo API Specification</a>.</p></div></div><div class="section"><h4>Project Definition<a name="Project_Definition"></a></h4><p>Once the mojos have been written for the plugin, it is time to build the plugin. To do this properly, the project's descriptor needs to have a number of settings set properly:</p><table border="1" class="bodyTable"><tr class="a"><td align="left"><tt>groupId</tt></td><td align="left">This is the group ID for the plugin, and should match the common prefix to t
he packages used by the mojos</td></tr><tr class="b"><td align="left"><tt>artifactId</tt></td><td align="left">This is the name of the plugin</td></tr><tr class="a"><td align="left"><tt>version</tt></td><td align="left">This is the version of the plugin</td></tr><tr class="b"><td align="left"><tt>packaging</tt></td><td align="left">This should be set to "<tt>maven-plugin</tt>"</td></tr><tr class="a"><td align="left"><tt>dependencies</tt></td><td align="left">A dependency must be declared to the Maven Plugin Tools API to resolve "<tt>AbstractMojo</tt>" and related classes</td></tr></table><p>Listed below is an illustration of the sample mojo project's pom with the parameters set as described in the above table:</p><div class="source"><pre><project>
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>sample.plugin</groupId>
+ <artifactId>hello-maven-plugin</artifactId>
+ <packaging>maven-plugin</packaging>
+ <version>1.0-SNAPSHOT</version>
+ <name>Sample Parameter-less Maven Plugin</name>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.maven</groupId>
+ <artifactId>maven-plugin-api</artifactId>
+ <version>2.0</version>
+ </dependency>
+ </dependencies>
+</project></pre></div></div><div class="section"><h4>Build Goals<a name="Build_Goals"></a></h4><p>There are few goals which are defined with the Maven plugin packaging as part of a standard build lifecycle:</p><table border="1" class="bodyTable"><tr class="a"><td align="left"><tt>compile</tt></td><td align="left">Compiles the Java code for the plugin and builds the plugin descriptor</td></tr><tr class="b"><td align="left"><tt>test</tt></td><td align="left">Runs the plugin's unit tests</td></tr><tr class="a"><td align="left"><tt>package</tt></td><td align="left">Builds the plugin jar</td></tr><tr class="b"><td align="left"><tt>install</tt></td><td align="left">Installs the plugin jar in the local repository</td></tr><tr class="a"><td align="left"><tt>deploy</tt></td><td align="left">Deploys the plugin jar to the remote repository</td></tr></table></div><div class="section"><h4>Executing Your First Mojo<a name="Executing_Your_First_Mojo"></a></h4><p>The most direct means
of executing your new plugin is to specify the plugin goal directly on the command line. To do this, you need to configure the <tt>hello-maven-plugin</tt> plugin in you project:</p><div class="source"><pre>...
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>sample.plugin</groupId>
+ <artifactId>hello-maven-plugin</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ </plugin>
+ </plugins>
+ </build>
+...</pre></div><p>And, you need to specify a fully-qualified goal in the form of:</p><div class="source"><pre>mvn groupID:artifactID:version:goal</pre></div><p>For example, to run the simple mojo in the sample plugin, you would enter "<tt>mvn sample.plugin:hello-maven-plugin:1.0-SNAPSHOT:sayhi</tt>" on the command line.</p><p><b>Tips</b>: <tt>version</tt> is not required to run a standalone goal.</p><div class="section"><h5>Shortening the Command Line<a name="Shortening_the_Command_Line"></a></h5><p>There are several ways to reduce the amount of required typing:</p><ul><li>If you need to run the latest version of a plugin installed in your local repository, you can omit its version number. So just use "<tt>mvn sample.plugin:hello-maven-plugin:sayhi</tt>" to run your plugin.</li><li>You can assign a shortened prefix to your plugin, such as <tt>mvn hello:sayhi</tt>. This is done automatically if you follow the convention of using <tt>${prefix}-maven-plugin<
/tt> (or <tt>maven-${prefix}-plugin</tt> if the plugin is part of the Apache Maven project). You may also assign one through additional configuration - for more information see <a href="../introduction/introduction-to-plugin-prefix-mapping.html"> Introduction to Plugin Prefix Mapping</a>.</li><li>Finally, you can also add your plugin's groupId to the list of groupIds searched by default. To do this, you need to add the following to your <tt>${user.home}/.m2/settings.xml</tt> file:<div class="source"><pre><pluginGroups>
+ <pluginGroup>sample.plugin</pluginGroup>
+</pluginGroups></pre></div></li></ul><p>At this point, you can run the mojo with "<tt>mvn hello:sayhi</tt>".</p></div><div class="section"><h5>Attaching the Mojo to the Build Lifecycle<a name="Attaching_the_Mojo_to_the_Build_Lifecycle"></a></h5><p>You can also configure your plugin to attach specific goals to a particular phase of the build lifecycle. Here is an example:</p><div class="source"><pre> <build>
+ <plugins>
+ <plugin>
+ <groupId>sample.plugin</groupId>
+ <artifactId>hello-maven-plugin</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ <executions>
+ <execution>
+ <phase>compile</phase>
+ <goals>
+ <goal>sayhi</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build></pre></div><p>This causes the simple mojo to be executed whenever Java code is compiled. For more information on binding a mojo to phases in the lifecycle, please refer to the <a href="../introduction/introduction-to-the-lifecycle.html">Build Lifecycle</a> document.</p></div></div></div><div class="section"><h3>Mojo archetype<a name="Mojo_archetype"></a></h3><p>To create a new plugin project, you could using the Mojo <a href="../introduction/introduction-to-archetypes.html">archetype</a> with the following command line:</p><div class="source"><pre>mvn archetype:generate \
+ -DgroupId=sample.plugin \
+ -DartifactId=hello-maven-plugin \
+ -DarchetypeGroupId=org.apache.maven.archetypes \
+ -DarchetypeArtifactId=maven-archetype-mojo</pre></div></div><div class="section"><h3><a name="Parameters">Parameters</a></h3><p>It is unlikely that a mojo will be very useful without parameters. Parameters provide a few very important functions:</p><ul><li>It provides hooks to allow the user to adjust the operation of the plugin to suit their needs.</li><li>It provides a means to easily extract the value of elements from the POM without the need to navigate the objects.</li></ul><div class="section"><h4>Defining Parameters Within a Mojo<a name="Defining_Parameters_Within_a_Mojo"></a></h4><p>Defining a parameter is as simple as creating an instance variable in the mojo and adding the proper annotations. Listed below is an example of a parameter for the simple mojo:</p><div class="source"><pre> /**
+ * The greeting to display.
+ *
+ * @parameter expression="${sayhi.greeting}" default-value="Hello World!"
+ */
+ private String greeting;</pre></div><p>The portion before the annotations is the description of the parameter. The <tt>parameter</tt> annotation identifies the variable as a mojo parameter. The <tt>default-value</tt> parameter of the annotation defines the default value for the variable. This value can include expressions which reference the project, such as "<tt>${project.version}</tt>" (more can be found in the "Parameter Expressions" document). The <tt>expression</tt> parameter can be used to allow configuration of the mojo parameter from the command line by referencing a system property that the user sets via the <tt>-D</tt> option.</p></div><div class="section"><h4>Configuring Parameters in a Project<a name="Configuring_Parameters_in_a_Project"></a></h4><p>Configuring the parameter values for a plugin is done in a Maven 2 project within the <tt>pom.xml</tt> file as part of defining the plugin in the project. An example of configuring a plugin:</p
><div class="source"><pre><plugin>
+ <groupId>sample.plugin</groupId>
+ <artifactId>hello-maven-plugin</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ <configuration>
+ <greeting>Welcome</greeting>
+ </configuration>
+</plugin></pre></div><p>In the configuration section, the element name ("<tt>greeting</tt>") is the parameter name and the contents of the element ("<tt>Welcome</tt>") is the value to be assigned to the parameter.</p><p><b>Note</b>: More details can be found in the <a href="../mini/guide-configuring-plugins.html">Guide to Configuring Plugins</a>.</p></div><div class="section"><h4>Parameter Types With One Value<a name="Parameter_Types_With_One_Value"></a></h4><p>Listed below are the various types of simple variables which can be used as parameters in your mojos, along with any rules on how the values in the POM are interpreted.</p><div class="section"><h5>Boolean<a name="Boolean"></a></h5><p>This includes variables typed <tt>boolean</tt> and <tt>Boolean</tt>. When reading the configuration, the text "<tt>true</tt>" causes the parameter to be set to true and all other text causes the parameter to be set to false. Example:</p><div class="sour
ce"><pre> /**
+ * My boolean.
+ *
+ * @parameter
+ */
+ private boolean myBoolean;</pre></div><div class="source"><pre><myBoolean>true</myBoolean></pre></div></div><div class="section"><h5>Fixed-Point Numbers<a name="Fixed-Point_Numbers"></a></h5><p>This includes variables typed <tt>byte</tt>, <tt>Byte</tt>, <tt>int</tt>, <tt>Integer</tt>, <tt>long</tt>, <tt>Long</tt>, <tt>short</tt>, and <tt>Short</tt>. When reading the configuration, the text in the XML file is converted to an integer value using either <tt>Integer.parseInt()</tt> or the <tt>valueOf()</tt> method of the appropriate class. This means that the strings must be valid decimal integer values, consisting only of the digits 0 to 9 with an optional <tt>-</tt> in front for a negative value. Example:</p><div class="source"><pre> /**
+ * My Integer.
+ *
+ * @parameter
+ */
+ private Integer myInteger;</pre></div><div class="source"><pre><myInteger>10</myInteger></pre></div></div><div class="section"><h5>Floating-Point Numbers<a name="Floating-Point_Numbers"></a></h5><p>This includes variables typed <tt>double</tt>, <tt>Double</tt>, <tt>float</tt>, and <tt>Float</tt>. When reading the configuration, the text in the XML file is converted to binary form using the <tt>valueOf()</tt> method for the appropriate class. This means that the strings can take on any format specified in section 3.10.2 of the Java Language Specification. Some samples of valid values are <tt>1.0</tt> and <tt>6.02E+23</tt>.</p><div class="source"><pre> /**
+ * My Double.
+ *
+ * @parameter
+ */
+ private Double myDouble;</pre></div><div class="source"><pre><myDouble>1.0</myDouble></pre></div></div><div class="section"><h5>Dates<a name="Dates"></a></h5><p>This includes variables typed <tt>Date</tt>. When reading the configuration, the text in the XML file is converted using one of the following date formats: "<tt>yyyy-MM-dd HH:mm:ss.S a</tt>" (a sample date is "2005-10-06 2:22:55.1 PM") or "<tt>yyyy-MM-dd HH:mm:ssa</tt>" (a sample date is "2005-10-06 2:22:55PM"). Note that parsing is done using <tt>DateFormat.parse()</tt> which allows some leniency in formatting. If the method can parse a date and time out of what is specified it will do so even if it doesn't exactly match the patterns above. Example:</p><div class="source"><pre> /**
+ * My Date.
+ *
+ * @parameter
+ */
+ private Date myDate;</pre></div><div class="source"><pre><myDate>2005-10-06 2:22:55.1 PM</myDate></pre></div></div><div class="section"><h5>Files and Directories<a name="Files_and_Directories"></a></h5><p>This includes variables typed <tt>File</tt>. When reading the configuration, the text in the XML file is used as the path to the desired file or directory. If the path is relative (does not start with <tt>/</tt> or a drive letter like <tt>C:</tt>), the path is relative to the directory containing the POM. Example:</p><div class="source"><pre> /**
+ * My File.
+ *
+ * @parameter
+ */
+ private File myFile;</pre></div><div class="source"><pre><myFile>c:\temp</myFile></pre></div></div><div class="section"><h5>URLs<a name="URLs"></a></h5><p>This includes variables typed <tt>URL</tt>. When reading the configuration, the text in the XML file is used as the URL. The format must follow the RFC 2396 guidelines, and looks like any web browser URL (<tt>scheme://host:port/path/to/file</tt>). No restrictions are placed on the content of any of the parts of the URL while converting the URL.</p><div class="source"><pre> /**
+ * My URL.
+ *
+ * @parameter
+ */
+ private URL myURL;</pre></div><div class="source"><pre><myURL>http://maven.apache.org</myURL></pre></div></div><div class="section"><h5>Plain Text<a name="Plain_Text"></a></h5><p>This includes variables typed <tt>char</tt>, <tt>Character</tt>, <tt>StringBuffer</tt>, and <tt>String</tt>. When reading the configuration, the text in the XML file is used as the value to be assigned to the parameter. For <tt>char</tt> and <tt>Character</tt> parameters, only the first character of the text is used.</p></div></div><div class="section"><h4>Parameter Types With Multiple Values<a name="Parameter_Types_With_Multiple_Values"></a></h4><p>Listed below are the various types of composite objects which can be used as parameters in your mojos, along with any rules on how the values in the POM are interpreted. In general, the class of the object created to hold the parameter value (as well as the class for each element within the parameter value) is determined as follows (the f
irst step which yields a valid class is used):</p><ol style="list-style-type: decimal"><li>If the XML element contains an <tt>implementation</tt> hint attribute, that is used</li><li>If the XML tag contains a <tt>.</tt>, try that as a fully qualified class name</li><li>Try the XML tag (with capitalized first letter) as a class in the same package as the mojo/object being configured</li><li>For arrays, use the component type of the array (for example, use <tt>String</tt> for a <tt>String[]</tt> parameter); for collections and maps, use the class specified in the mojo configuration for the collection or map; use <tt>String</tt> for entries in a collection and values in a map</li></ol><p>Once the type for the element is defined, the text in the XML file is converted to the appropriate type of object</p><div class="section"><h5>Arrays<a name="Arrays"></a></h5><p>Array type parameters are configured by specifying the parameter multiple times. Example:</p><div class="source"><pre>
/**
+ * My Array.
+ *
+ * @parameter
+ */
+ private String[] myArray;</pre></div><div class="source"><pre><myArray>
+ <param>value1</param>
+ <param>value2</param>
+</myArray></pre></div></div><div class="section"><h5>Collections<a name="Collections"></a></h5><p>This category covers any class which implements <tt>java.util.Collection</tt> such as <tt>ArrayList</tt> or <tt>HashSet</tt>. These parameters are configured by specifying the parameter multiple times just like an array. Example:</p><div class="source"><pre> /**
+ * My List.
+ *
+ * @parameter
+ */
+ private List myList;</pre></div><div class="source"><pre><myList>
+ <param>value1</param>
+ <param>value2</param>
+</myList></pre></div><p>For details on the mapping of the individual collection elements, see <a href="../mini/guide-configuring-plugins.html#Mapping_Lists">Mapping Lists</a>.</p></div><div class="section"><h5>Maps<a name="Maps"></a></h5><p>This category covers any class which implements <tt>java.util.Map</tt> such as <tt>HashMap</tt> but does <b>not</b> implement <tt>java.util.Properties</tt>. These parameters are configured by including XML tags in the form <tt> <key>value</key> </tt> in the parameter configuration. Example:</p><div class="source"><pre> /**
+ * My Map.
+ *
+ * @parameter
+ */
+ private Map myMap;</pre></div><div class="source"><pre><myMap>
+ <key1>value1</key1>
+ <key2>value2</key2>
+</myMap></pre></div></div><div class="section"><h5>Properties<a name="Properties"></a></h5><p>This category covers any map which implements <tt>java.util.Properties</tt>. These parameters are configured by including XML tags in the form <tt> <property><name>myName</name> <value>myValue</value> </property> </tt> in the parameter configuration. Example:</p><div class="source"><pre> /**
+ * My Properties.
+ *
+ * @parameter
+ */
+ private Properties myProperties;</pre></div><div class="source"><pre><myProperties>
+ <property>
+ <name>propertyName1</name>
+ <value>propertyValue1</value>
+ <property>
+ <property>
+ <name>propertyName2</name>
+ <value>propertyValue2</value>
+ <property>
+</myProperties></pre></div></div><div class="section"><h5>Other Object Classes<a name="Other_Object_Classes"></a></h5><p>This category covers any class which does not implement <tt>java.util.Map</tt>, <tt>java.util.Collection</tt>, or <tt>java.util.Dictionary</tt>. Example:</p><div class="source"><pre> /**
+ * My Object.
+ *
+ * @parameter
+ */
+ private MyObject myObject;</pre></div><div class="source"><pre><myObject>
+ <myField>test</myField>
+</myObject></pre></div><p>Please see <a href="../mini/guide-configuring-plugins.html#Mapping_Complex_Objects">Mapping Complex Objects</a> for details on the strategy used to configure those kind of parameters.</p></div></div></div><div class="section"><h3>Using Setters<a name="Using_Setters"></a></h3><p>You are not restricted to using private field mapping which is good if you are trying to make you Mojos resuable outside the context of Maven. Using the example above we could name our private fields using the underscore convention and provide setters that the configuration mapping mechanism can use. So our Mojo would look like the following:</p><div class="source"><pre>
+public class MyQueryMojo
+ extends AbstractMojo
+{
+ /**
+ * @parameter property="url"
+ */
+ private String _url;
+
+ /**
+ * @parameter property="timeout"
+ */
+ private int _timeout;
+
+ /**
+ * @parameter property="options"
+ */
+ private String[] _options;
+
+ public void setUrl( String url )
+ {
+ _url = url;
+ }
+
+ public void setTimeout( int timeout )
+ {
+ _timeout = timeout;
+ }
+
+ public void setOptions( String[] options )
+ {
+ _options = options;
+ }
+
+ public void execute()
+ throws MojoExecutionException
+ {
+ ...
+ }
+}
+</pre></div><p>Note the specification of the property name for each parameter which tells Maven what setter and getter to use when the field's name does not match the intended name of the parameter in the plugin configuration.</p></div><div class="section"><h3>Resources<a name="Resources"></a></h3><ol style="list-style-type: decimal"><li><a href="../../developers/mojo-api-specification.html">Mojo Documentation</a>: Mojo API, Mojo annotations</li><li><a class="externalLink" href="http://maven.apache.org/shared/maven-plugin-testing-harness/">Maven Plugin Testing Harness</a>: Testing framework for your Mojos.</li><li><a class="externalLink" href="http://plexus.codehaus.org/">Plexus</a>: The IoC container used by Maven.</li><li><a class="externalLink" href="http://plexus.codehaus.org/plexus-utils/">Plexus Common Utilities</a>: Set of utilities classes useful for Mojo development.</li><li><a class="externalLink" href="http://commons.apache.org/io/">Commons IO</a>: Set of utilitie
s classes useful for file/path handling.</li><li><a href="../../plugin-developers/common-bugs.html">Common Bugs and Pitfalls</a>: Overview of problematic coding patterns.</li></ol></div></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2012
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: websites/staging/maventest/trunk/content/images/Close_Repo.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/Close_Repo.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/images/Promote.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/Promote.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/images/Validate_Artifacts.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/Validate_Artifacts.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/images/apache-maven-project-2.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/apache-maven-project-2.png
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/maventest/trunk/content/images/archiva.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/archiva.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/images/banner.jpg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/banner.jpg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/maventest/trunk/content/images/bg.jpg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/bg.jpg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/maventest/trunk/content/images/books/apache_maven_2_effective_implementation.jpg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/books/apache_maven_2_effective_implementation.jpg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/maventest/trunk/content/images/books/apache_maven_3_0_cookbook.jpg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/books/apache_maven_3_0_cookbook.jpg
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/images/books/better_builds.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/books/better_builds.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/images/books/definitive_guide.jpg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/books/definitive_guide.jpg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/maventest/trunk/content/images/books/developer_notebook.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/books/developer_notebook.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/staging/maventest/trunk/content/images/books/pearson_apache_maven_fr.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/books/pearson_apache_maven_fr.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/images/breadcrumbs.jpg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/breadcrumbs.jpg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/maventest/trunk/content/images/collapsed.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/collapsed.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/staging/maventest/trunk/content/images/continuum.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/continuum.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/images/expanded.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/expanded.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/staging/maventest/trunk/content/images/external.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/external.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/images/folder-open.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/folder-open.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/staging/maventest/trunk/content/images/h3.jpg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/h3.jpg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/maventest/trunk/content/images/h5.jpg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/h5.jpg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/maventest/trunk/content/images/icon_error_sml.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/icon_error_sml.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/staging/maventest/trunk/content/images/icon_info_sml.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/icon_info_sml.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/staging/maventest/trunk/content/images/icon_success_sml.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/icon_success_sml.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/staging/maventest/trunk/content/images/icon_warning_sml.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/icon_warning_sml.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/staging/maventest/trunk/content/images/logo_apache.jpg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/logo_apache.jpg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/maventest/trunk/content/images/logo_maven.jpg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/logo_maven.jpg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/maventest/trunk/content/images/logos/build-by-maven-black.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/logos/build-by-maven-black.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/images/logos/build-by-maven-white.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/logos/build-by-maven-white.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/images/logos/maven-feather.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/logos/maven-feather.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/images/maven-1.x.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/maven-1.x.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/images/maven-logo-2.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/maven-logo-2.gif
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/maventest/trunk/content/images/maventxt_logo_200.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/maventxt_logo_200.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/staging/maventest/trunk/content/images/newwindow.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/images/newwindow.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/index.html
==============================================================================
--- websites/staging/maventest/trunk/content/index.html (added)
+++ websites/staging/maventest/trunk/content/index.html Thu Mar 1 23:08:58 2012
@@ -0,0 +1,458 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Mar 1, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>
+ Welcome to Apache Maven</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Brett Porter" />
+ <meta name="author" content="Jason van Zyl" />
+ <meta name="Date-Revision-yyyymmdd" content="20120301" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="./" id="bannerLeft">
+ <img src="images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="index.html">Maven</a>
+ >
+
+ Welcome to Apache Maven
+ </div>
+ <div class="xright">
+ Last Published: 2012-03-01
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Main</h5>
+ <ul>
+ <li class="none">
+ <strong>Welcome</strong>
+ </li>
+ </ul>
+ <h5>Get Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="download.html">Download</a>
+ </li>
+ <li class="none">
+ <a href="docs/3.0.4/release-notes.html">Release Notes (3.0.4)</a>
+ </li>
+ <li class="none">
+ <a href="docs/2.2.1/release-notes.html">Release Notes (2.2.1)</a>
+ </li>
+ <li class="none">
+ <a href="docs/2.0.11/release-notes.html">Release Notes (2.0.11)</a>
+ </li>
+ <li class="none">
+ <a href="license.html">License</a>
+ </li>
+ </ul>
+ <h5>IDE Integration</h5>
+ <ul>
+ <li class="none">
+ <a href="eclipse-plugin.html">Eclipse</a>
+ </li>
+ <li class="none">
+ <a href="netbeans-module.html">NetBeans</a>
+ </li>
+ </ul>
+ <h5>About Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="what-is-maven.html">What is Maven?</a>
+ </li>
+ <li class="none">
+ <a href="maven-features.html">Features</a>
+ </li>
+ <li class="none">
+ <a href="general.html">FAQ (official)</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/FAQs-1" class="externalLink">FAQ (unofficial)</a>
+ </li>
+ <li class="none">
+ <a href="powered-by-m2.html">Powered By</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li class="none">
+ <a href="plugins/index.html">Maven Plugins</a>
+ </li>
+ <li class="none">
+ <a href="guides/index.html">Index (category)</a>
+ </li>
+ <li class="none">
+ <a href="run-maven/index.html">Running Maven</a>
+ </li>
+ <li class="collapsed">
+ <a href="users/index.html">User Centre</a>
+ </li>
+ <li class="collapsed">
+ <a href="plugin-developers/index.html">Plugin Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="repository/index.html">Maven Repository Centre</a>
+ </li>
+ <li class="none">
+ <a href="developers/index.html">Maven Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="articles.html">Books and Resources</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/Home" class="externalLink">Wiki</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="community.html">Community Overview</a>
+ </li>
+ <li class="none">
+ <a href="guides/development/guide-helping.html">How to Contribute</a>
+ </li>
+ <li class="none">
+ <a href="guides/mini/guide-maven-evangelism.html">Maven Repository</a>
+ </li>
+ <li class="none">
+ <a href="users/getting-help.html">Getting Help</a>
+ </li>
+ <li class="none">
+ <a href="issue-tracking.html">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="source-repository.html">Source Repository</a>
+ </li>
+ <li class="none">
+ <a href="team-list.html">The Maven Team</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="project-info.html">Project Information</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <strong>Maven 2 & 3</strong>
+ </li>
+ <li class="none">
+ <a href="plugins/index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="./images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License. -->
+
+
+ <!-- TODO: news? -->
+ <div class="section"><h2></h2> <!-- valid xdoc needs at least a section -->
+ <div id="downloadbox">
+ <div class="section"><div class="section"><div class="section"><h5>Search Maven Sites<a name="Search_Maven_Sites"></a></h5>
+<!-- Google CSE Search Box Begins -->
+<form action="http://www.google.com/cse" id="searchbox_006660305041243700248:hyqtfwsewpm">
+ <input type="hidden" name="cx" value="006660305041243700248:hyqtfwsewpm" />
+ <input type="text" name="q" size="25" />
+ <input type="submit" name="sa" value="Search" />
+</form>
+<script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=searchbox_006660305041243700248%3Ahyqtfwsewpm"></script>
+<!-- Google CSE Search Box Ends -->
+ </div><div class="section"><h5>Get Maven 3.0.4<a name="Get_Maven_3.0.4"></a></h5>
+ <span style="display: block; text-align: right; font-size: smaller">Released: 20 January 2012</span>
+ <p>
+ <a href="download.html">
+ <img src="images/folder-open.gif" border="0" alt="" title="Download Maven 3.0.4" />
+ Maven 3.0.4
+ </a>
+ <span style="font-size: smaller">
+ <br />
+ <a href="docs/3.0.4/release-notes.html">Release Notes</a>,
+ <a href="download.html#Requirements">System Requirements</a>,
+ <a href="download.html#Installation">Installation Instructions</a>
+ </span>
+ </p>
+ </div><div class="section"><h5>ApacheCon NA 2011<a name="ApacheCon_NA_2011"></a></h5>
+ <p>
+ <a class="poweredBy" href="http://www.apache.org/events/current-event.html" title="ApacheCon">
+ <img src="http://www.apache.org/events/current-event-125x125.png" class="poweredBy" alt="ApacheCon" />
+ </a>
+ </p>
+ </div><div class="section"><h5>Get Maven Ant Tasks<a name="Get_Maven_Ant_Tasks"></a></h5>
+ <span style="display: block; text-align: right; font-size: smaller">Released: 17 Apr 2011</span>
+ <p>
+ <a href="ant-tasks/download.html">
+ <img src="images/folder-open.gif" border="0" alt="" title="Download Maven Tasks for Ant 2.1.3" />
+ Maven Tasks for Ant 2.1.3
+ </a>
+ <span style="font-size: smaller">
+ <br />
+ <a href="ant-tasks/release-notes.html">Release Notes</a>,
+ <a href="ant-tasks/index.html">Documentation</a>
+ </span>
+ </p>
+
+ <!-- TODO: we should use the SSI instead, but two things prevent it: a) the SSI's aren't working on apache.org yet so I can't test it; b) SSI's get eliminated from xdoc. For some reason even inside CDATA they are escaped. -->
+<!-- <h5>ApacheCon NA 2010</h5>
+ <iframe src="http://www.apache.org/ads/bannerbar.html" style="margin-left: -13px; margin-top: -3px; padding: 0" frameborder="0" scrolling="no" width="247" height="70"></iframe>
+ <ul><li><a href="http://na.apachecon.com/c/acna2010/sessions/628">Maven full-day training</a></li>
+ <li><a href="http://wiki.apache.org/apachecon/ApacheMeetupsNa10">Proposed Maven Meetup</a></li></ul> -->
+ </div><div class="section"><h5>Looking for Artifacts?<a name="Looking_for_Artifacts"></a></h5>
+ <p><a class="externalLink" href="http://repository.sonatype.org">Search Central</a> and other Public Repositories.</p>
+ </div><div class="section"><h5>Looking for Repository Managers?<a name="Looking_for_Repository_Managers"></a></h5>
+ <p><a class="externalLink" href="http://maven.apache.org/repository-management.html">Take a look</a> at the Repository Managers available from the community.</p>
+ </div><div class="section"><h5>Looking for CI Servers?<a name="Looking_for_CI_Servers"></a></h5>
+ <p><a class="externalLink" href="http://maven.apache.org/continuous-integration.html">Take a look</a> at the CI Servers available from the community.</p>
+ </div><div class="section"><h5>Looking for Code Quality Management tools?<a name="Looking_for_Code_Quality_Management_tools"></a></h5>
+ <p><a class="externalLink" href="http://maven.apache.org/code-quality-management.html">Take a look</a> at the Code Quality Management platforms available from the community.</p>
+
+ </div><div class="section"><h5>Supporting Maven<a name="Supporting_Maven"></a></h5>
+ <p>We'd like to <a class="externalLink" href="http://www.apache.org/foundation/thanks.html">thank the sponsors of the Apache Software Foundation</a> for their support and assistance. To support the ASF, see the <a class="externalLink" href="http://www.apache.org/foundation/sponsorship.html">sponsorship</a> page.</p>
+ </div>
+ </div></div></div></div>
+
+ <div class="section"><h2>Welcome to Apache Maven CMS/svnpubsub Test<a name="Welcome_to_Apache_Maven_CMSsvnpubsub_Test"></a></h2>
+<p>This text was edited and published through <a class="externalLink" href="https://cms.apache.org/maventest/">the CMS web interface</a>, and its bookmarklet to discover the source file. Great!</p>
+ <!-- TODO: I reckon it's time for a new description -->
+ <p>
+ Apache Maven is a software project management and comprehension tool. Based on the concept of a project object model
+ (POM), Maven can manage a project's build, reporting and documentation from a central piece of information.
+ </p>
+ <p>
+ If you think that Maven could help your project, you can find out more information about in the "About Maven"
+ section of the navigation. This includes an in-depth description of <a href="what-is-maven.html">what Maven is</a>,
+ a <a href="maven-features.html">list of some of its main features</a>, and a set of <a href="general.html">frequently
+ asked questions about what Maven is</a>.
+ </p>
+ <div class="section"><h3>Learning about Maven<a name="Learning_about_Maven"></a></h3>
+ <p>
+ <!-- TODO: this could be the big button type thing instead of a list of links -->
+ This site is separated into the following sections, depending on how you'd like to use Maven:
+ </p>
+ <!-- TODO: use CSS -->
+ <ul>
+ <li>
+ <span style="white-space:nowrap; font-weight: bold; font-size: 1.25em">
+ <a href="run-maven/index.html">Run Maven</a>
+ </span>
+ <span style="display: block; margin-bottom: 0.5em">
+ Information for those needing to build a project that uses Maven
+ </span>
+ </li>
+ <li>
+ <span style="white-space:nowrap; font-weight: bold; font-size: 1.25em">
+ <a href="users/index.html">Use Maven</a>
+ </span>
+ <span style="display: block; margin-bottom: 0.5em">
+ Information for those wanting to use Maven to build their project, including a "10 minute test" that gives a
+ practical overview of Maven's main features in just 10 minutes
+ </span>
+ </li>
+ <li>
+ <span style="white-space:nowrap; font-weight: bold; font-size: 1.25em">
+ <a href="plugin-developers/index.html">Write Maven Plugins</a>
+ </span>
+ <span style="display: block; margin-bottom: 0.5em">
+ Information for those who may or may not be using Maven, but want to provide a plugin for shared
+ functionality or to accompany their own product or toolset
+ </span>
+ </li>
+ <li>
+ <span style="white-space:nowrap; font-weight: bold; font-size: 1.25em">
+ <a href="repository/index.html">Improve the Maven Repository</a>
+ </span>
+ <span style="display: block; margin-bottom: 0.5em">
+ Information for those who may or may not use, but are interested in getting project metadata into the
+ repository
+ </span>
+ </li>
+ <li>
+ <span style="white-space:nowrap; font-weight: bold; font-size: 1.25em">
+ <a href="developers/index.html">Develop Maven</a>
+ </span>
+ <span style="display: block; margin-bottom: 0.5em">
+ Information for those who are currently developers, or who are interested
+ in contributing to the Maven project itself
+ </span>
+ </li>
+ </ul>
+ <p>
+ Each guide is divided into a number of trails to get you started on a particular topic, and includes a
+ reference area and a "cookbook" of common examples.
+ </p>
+ <p>
+ You can access the guides at any time from the left navigation.
+ </p>
+ </div><div class="section"><h3>Documentation Index<a name="Documentation_Index"></a></h3>
+ <p>
+ If you are looking for a quick reference, you can use the <a href="guides/index.html">documentation index.</a>
+<!-- TODO
+ If you are looking for a quick reference, you can use the documentation index. It is available in both
+ <a href="todo.html">alphabetical</a> and <a href="todo.html">categorical</a> listing formats. -->
+ </p>
+ </div><div class="section"><h3>Plugins<a name="Plugins"></a></h3>
+<!-- TODO
+ <p>
+ Maven functionality is provided by plugins. For an explanation of how plugins work, and basic information on how
+ to use a plugin, see the <a href="todo.html">introduction to plugins</a> in the Users Centre.
+ </p> -->
+ <p>
+ For detailed information on just some of the plugins available for Maven, see the
+ <a href="plugins/index.html">plugin list</a>.
+ </p>
+<!-- TODO: Should these be here, or just in the user centre?
+ <h3>Converting from a different Build System</h3>
+ <p>
+ If you are currently using a different build system, there are options for converting from that to Maven 2
+ either partially or completely. These guides also give an overview of the differences between Maven and the
+ other build system. The following guides are available in the Users Centre:
+ </p>
+ <ul>
+ <li><a href="todo.html">Converting from Ant to Maven 2</a></li>
+ <li><a href="todo.html">Converting from Maven 1.x to Maven 2</a></li>
+ <li><a href="todo.html">Adding Maven 2 to an IDE based build</a></li>
+ </ul> -->
+ </div><div class="section"><h3>How to Get Support<a name="How_to_Get_Support"></a></h3>
+ <p>
+ Support for Maven is available in a variety of different forms.
+ </p>
+ <p>
+ To get started, search the documentation, the <a class="externalLink" href="http://docs.codehaus.org/display/MAVENUSER">wiki</a>,
+ <a href="issue-tracking.html">issue tracker</a>, or the <a href="mail-lists.html">mailing list archives</a> to
+ see if the problem has been solved or reported before.
+ </p>
+ <p>
+ If the problem has not been reported before, the recommended way to get help is to
+ subscribe to the <a href="mail-lists.html">Maven Users Mailing list</a>. Many other users and Maven developers
+ will answer your questions there, and the answer will be archived for others in the future.
+ </p>
+ <p>
+ You can also reach the Maven developers on <a href="community.html">IRC</a>.
+ </p>
+
+ </div><div class="section"><h3>How can I help?<a name="How_can_I_help"></a></h3>
+ <p>
+ Maven is an open source community and welcomes contributions. If you'd like to get involved, see the
+ <a href="guides/development/guide-helping.html">Guide to helping with Maven</a>.
+ </p>
+ <p>
+ Maven is a part of the Apache Software Foundation. We'd like to <a class="externalLink" href="http://www.apache.org/foundation/thanks.html">thank
+ the sponsors</a> that provide financial assistance to the foundation. For more information on how you can support the
+ foundation, see the <a class="externalLink" href="http://www.apache.org/foundation/sponsorship.html">sponsorship</a> page.
+ </p>
+ </div></div>
+
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2012
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: websites/staging/maventest/trunk/content/integration.html
==============================================================================
--- websites/staging/maventest/trunk/content/integration.html (added)
+++ websites/staging/maventest/trunk/content/integration.html Thu Mar 1 23:08:58 2012
@@ -0,0 +1,254 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Mar 1, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Continuous Integration</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ <meta name="Date-Revision-yyyymmdd" content="20120301" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="./" id="bannerLeft">
+ <img src="images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="index.html">Maven</a>
+ >
+ Continuous Integration
+ </div>
+ <div class="xright">
+ Last Published: 2012-03-01
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Main</h5>
+ <ul>
+ <li class="none">
+ <a href="index.html">Welcome</a>
+ </li>
+ </ul>
+ <h5>Get Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="download.html">Download</a>
+ </li>
+ <li class="none">
+ <a href="docs/3.0.4/release-notes.html">Release Notes (3.0.4)</a>
+ </li>
+ <li class="none">
+ <a href="docs/2.2.1/release-notes.html">Release Notes (2.2.1)</a>
+ </li>
+ <li class="none">
+ <a href="docs/2.0.11/release-notes.html">Release Notes (2.0.11)</a>
+ </li>
+ <li class="none">
+ <a href="license.html">License</a>
+ </li>
+ </ul>
+ <h5>IDE Integration</h5>
+ <ul>
+ <li class="none">
+ <a href="eclipse-plugin.html">Eclipse</a>
+ </li>
+ <li class="none">
+ <a href="netbeans-module.html">NetBeans</a>
+ </li>
+ </ul>
+ <h5>About Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="what-is-maven.html">What is Maven?</a>
+ </li>
+ <li class="none">
+ <a href="maven-features.html">Features</a>
+ </li>
+ <li class="none">
+ <a href="general.html">FAQ (official)</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/FAQs-1" class="externalLink">FAQ (unofficial)</a>
+ </li>
+ <li class="none">
+ <a href="powered-by-m2.html">Powered By</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li class="none">
+ <a href="plugins/index.html">Maven Plugins</a>
+ </li>
+ <li class="none">
+ <a href="guides/index.html">Index (category)</a>
+ </li>
+ <li class="none">
+ <a href="run-maven/index.html">Running Maven</a>
+ </li>
+ <li class="collapsed">
+ <a href="users/index.html">User Centre</a>
+ </li>
+ <li class="collapsed">
+ <a href="plugin-developers/index.html">Plugin Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="repository/index.html">Maven Repository Centre</a>
+ </li>
+ <li class="none">
+ <a href="developers/index.html">Maven Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="articles.html">Books and Resources</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/Home" class="externalLink">Wiki</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="community.html">Community Overview</a>
+ </li>
+ <li class="none">
+ <a href="guides/development/guide-helping.html">How to Contribute</a>
+ </li>
+ <li class="none">
+ <a href="guides/mini/guide-maven-evangelism.html">Maven Repository</a>
+ </li>
+ <li class="none">
+ <a href="users/getting-help.html">Getting Help</a>
+ </li>
+ <li class="none">
+ <a href="issue-tracking.html">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="source-repository.html">Source Repository</a>
+ </li>
+ <li class="none">
+ <a href="team-list.html">The Maven Team</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="expanded">
+ <a href="project-info.html">Project Information</a>
+ <ul>
+ <li class="none">
+ <strong>Continuous Integration</strong>
+ </li>
+ <li class="none">
+ <a href="mail-lists.html">Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="license.html">Project License</a>
+ </li>
+ <li class="none">
+ <a href="team-list.html">Project Team</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="plugins/index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="./images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <div class="section"><h2>Overview<a name="Overview"></a></h2><a name="Overview"></a><p>This project uses <a class="externalLink" href="http://jenkins-ci.org/">Jenkins</a>.</p></div><div class="section"><h2>Access<a name="Access"></a></h2><a name="Access"></a><p>The following is a link to the continuous integration system used by the project.</p><div class="source"><pre><a class="externalLink" href="https://builds.apache.org/hudson/view/M-R/view/Maven">https://builds.apache.org/hudson/view/M-R/view/Maven</a></pre></div></div><div class="section"><h2>Notifiers<a name="Notifiers"></a></h2><a name="Notifiers"></a><p>Configuration for notifying developers/users when a build is unsuccessful, including user information and notification mode.</p><table border="0" class="bodyTable"><tr class="a"><th>Type</th><th>Address</th><th>Configuration</th></tr><tr class="b"><td>mail</td><td>-</td><td>address=notifications@maven.apache.org</td></tr></table></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2012
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>