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/01 17:35:47 UTC
svn commit: r806895 [28/46] - in /websites/staging/maventest/trunk: ./
content/ content/ant/ content/background/ content/css/ content/developers/
content/developers/conventions/ content/developers/release/
content/developers/website/ content/docs/ cont...
Added: websites/staging/maventest/trunk/content/guides/mini/guide-http-settings.html
==============================================================================
--- websites/staging/maventest/trunk/content/guides/mini/guide-http-settings.html (added)
+++ websites/staging/maventest/trunk/content/guides/mini/guide-http-settings.html Thu Mar 1 16:35:39 2012
@@ -0,0 +1,412 @@
+<!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 Advanced HTTP Wagon Configuration</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="John Casey" />
+ <meta name="Date-Creation-yyyymmdd" content="20111212" />
+ <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 Advanced HTTP Wagon Configuration
+ </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="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>Advanced Configuration of the HttpClient HTTP Wagon<a name="Advanced_Configuration_of_the_HttpClient_HTTP_Wagon"></a></h2><ul><li><a href="#Advanced_Configuration_of_the_HttpClient_HTTP_Wagon">Advanced Configuration of the HttpClient HTTP Wagon</a><ul><li><a href="#Notice_on_Maven_Versioning_and_Availability">Notice on Maven Versioning and Availability</a><ul><li><a href="#Maven_2.2.0">Maven 2.2.0</a></li><li><a href="#Maven_2.2.1">Maven 2.2.1</a></li><li><a href="#Maven_3.0.4">Maven 3.0.4</a></li></ul></li><li><a href="#Introduction">Introduction</a></li><li><a href="#The_Basics">The Basics</a></li><li><a href="#Configuring_GET_HEAD_PUT_or_All_of_the_Above">Configuring GET, HEAD, PUT, or All of the Above</a></li><li><a href="#Taking_Control_of_Your_HTTP_Headers">Taking Control of Your HTTP Headers</a></li><li><a href="#Fine-Tuning_HttpClient_Parameters">Fine-Tuning HttpClient Parameters</a><ul><li><a href="#Non-String_Paramete
r_Values">Non-String Parameter Values</a></li><li><a href="#Example:_Using_Preemptive_Authentication">Example: Using Preemptive Authentication</a></li><li><a href="#Ignoring_Cookies">Ignoring Cookies</a></li></ul></li><li><a href="#Support_for_General-Wagon_Configuration_Standards">Support for General-Wagon Configuration Standards</a><ul><li><a href="#HTTP_Headers">HTTP Headers</a></li><li><a href="#Connection_Timeouts">Connection Timeouts</a></li><li><a href="#Read_time_out">Read time out</a></li></ul></li><li><a href="#Resources">Resources</a></li></ul></li></ul><div class="section"><h3>Notice on Maven Versioning and Availability<a name="Notice_on_Maven_Versioning_and_Availability"></a></h3><div class="section"><h4>Maven 2.2.0<a name="Maven_2.2.0"></a></h4><p>Starting in <b>Maven 2.2.0</b>, the HttpClient wagon was the implementation in use. The remainder of this document deals specifically with the differences between the HttpClient- and Sun-based HTTP wagons.</p></div><d
iv class="section"><h4>Maven 2.2.1<a name="Maven_2.2.1"></a></h4><p>Due to several critical issues introduced by the HttpClient-based HTTP wagon, <b>Maven 2.2.1</b> reverted back to the Sun implementation (a.k.a. 'lightweight') of the HTTP wagon as the default for HTTP/HTTPS transfers. The issues with the HttpClient-based wagon were mainly related to checksums, transfer timeouts, and NTLM proxies, and served as the primary cause for the release of <b>2.2.1</b> in the first place.</p><p><b>However</b>, starting in <b>Maven 2.2.1</b> you have a choice: you can use the default wagon implementation for a given protocol, or you can select an alternative wagon <tt>provider</tt> you'd like to use on a per-protocol basis. For more information, see the <a href="./guide-wagon-providers.html">Guide to Wagon Providers</a> [3].</p></div><div class="section"><h4>Maven 3.0.4<a name="Maven_3.0.4"></a></h4><p>With 3.0.4, the default wagon http(s) is now the HttpClient based on <a class="exte
rnalLink" href="http://hc.apache.org/httpcomponents-client-ga">Apache Http Client 4.1.2</a>. There is now a http connection pooling to prevent reopening http(s) to remote server for each requests. This pool feature is configurable with some parameters [4].</p><p>This new defaut wagon comes with some default configuration:</p><ul><li>http(s) connection pool: default to 20.</li><li>readTimeout: default to 1800000ms (~30 minutes) (see section <tt>Read time out</tt> below)</li><li>default Preemptive Authentication.</li></ul></div></div><div class="section"><h3>Introduction<a name="Introduction"></a></h3><p>Using the HttpClient-based HTTP wagon, you have a lot more control over the configuration used to access HTTP-based Maven repositories. For starters, you have fine-grained control over what HTTP headers are used when resolving artifacts. In addition, you can also configure a wide range of parameters to control the behavior of HttpClient itself. Best of all, you have the abilit
y to control these headers and parameters for all requests, or individual request types (Maven issues GET, HEAD, and PUT requests for different parts of the artifact-management subsystem).</p></div><div class="section"><h3>The Basics<a name="The_Basics"></a></h3><p>Without any special configuration, Maven's HTTP wagon will use some default HTTP headers and client parameters when managing artifacts. The default headers are:</p><div class="source"><pre>Cache-control: no-cache
+Cache-store: no-store
+Pragma: no-cache
+Expires: 0
+Accept-Encoding: gzip</pre></div><p>In addition, PUT requests made with the HTTP wagon will use the following HttpClient parameter:</p><div class="source"><pre>http.protocol.expect-continue=true</pre></div><p>From the HttpClient documentation[2], this parameter provides the following functionality:</p><div><pre>Activates 'Expect: 100-Continue' handshake for the entity enclosing methods.
+The 'Expect: 100-Continue' handshake allows a client that is sending a request
+message with a request body to determine if the origin server is willing to
+accept the request (based on the request headers) before the client sends the
+request body.
+
+The use of the 'Expect: 100-continue' handshake can result in noticeable performance
+improvement for entity enclosing requests (such as POST and PUT) that require
+the target server's authentication.
+
+'Expect: 100-continue' handshake should be used with caution, as it may cause
+problems with HTTP servers and proxies that do not support HTTP/1.1 protocol.</pre></div><p>Without this setting, PUT requests that require authentication will transfer their entire payload to the server before that server issues an authentication challenge. In order to complete the PUT request, the client must then re-send the payload with the proper credentials specified in the HTTP headers. This results in twice the bandwidth usage, and twice the time to transfer each artifact.</p><p>Another option to avoid this double transfer is what's known as preemptive authentication, which involves sending the authentication headers along with the original PUT request. However, there are a few potential issues with this approach. For one thing, in the event you have an unused <tt><server></tt> entry that specifies an invalid username/password combination, some servers may respond with a <tt>401 Unauthorized</tt> even if the server doesn't actually require any authentication fo
r the request. In addition, blindly sending authentication credentials with every request regardless of whether the server has made a challenge can result in a security hole, since the server may not make provisions to secure credentials for paths that don't require authentication.</p><p>We'll discuss preemptive authentication in another example, below.</p></div><div class="section"><h3>Configuring GET, HEAD, PUT, or All of the Above<a name="Configuring_GET_HEAD_PUT_or_All_of_the_Above"></a></h3><p>In all of the examples below, it's important to understand that we can configure the HTTP settings for all requests made to a given server, or for only one method. To configure all methods for a server, you'd use the following section of the <tt>settings.xml</tt> file:</p><div class="source"><pre><settings>
+ [...]
+ <servers>
+ <server>
+ <id>the-server</id>
+ <configuration>
+ <httpConfiguration>
+ <all>
+ [ Your configuration here. ]
+ </all>
+ </httpConfiguration>
+ </configuration>
+ </server>
+ </servers>
+</settings></pre></div><p>On the other hand, if you can live with the default configuration for most requests - say, HEAD and GET requests, which are used to check for the existence of a file and retrieve a file respectively - maybe you only need to configure the PUT method:</p><div class="source"><pre><settings>
+ [...]
+ <servers>
+ <server>
+ <id>the-server</id>
+ <configuration>
+ <httpConfiguration>
+ <put>
+ [ Your configuration here. ]
+ </put>
+ </httpConfiguration>
+ </configuration>
+ </server>
+ </servers>
+</settings></pre></div><p>For clarity, the other two sections are <tt><get></tt> for GET requests, and <tt><head></tt> for HEAD requests. I know that's going to be hard to remember...</p></div><div class="section"><h3>Taking Control of Your HTTP Headers<a name="Taking_Control_of_Your_HTTP_Headers"></a></h3><p>As you may have noticed above, the default HTTP headers do have the potential to cause problems. For instance, some websites set the encoding for downloading GZipped files as <tt>gzip</tt>, in spite of the fact that the HTTP request itself isn't being sent using GZip compression. If the client is using the <tt>Accept-Encoding: gzip</tt> header, this can result in the client itself decompressing the GZipped file <i>during the transfer</i> and writing the decompressed file to the local disk with the original filename. This can be misleading to say the least, and can use up an inordinate amount of disk space on the local computer.</p><p>To turn off this d
efault behavior, we'll simply disable the default headers. Then, we'll need to respecify the other headers that we are still interested in, like this:</p><div class="source"><pre><settings>
+ [...]
+ <servers>
+ <server>
+ <id>openssl</id>
+ <configuration>
+ <httpConfiguration>
+ <put>
+ <useDefaultHeaders>false</useDefaultHeaders>
+ <headers>
+ <header>
+ <name>Cache-control</name>
+ <value>no-cache</value>
+ </header>
+ <header>
+ <name>Cache-store</name>
+ <value>no-store</value>
+ </header>
+ <header>
+ <name>Pragma</name>
+ <value>no-cache</value>
+ </header>
+ <header>
+ <name>Expires</name>
+ <value>0</value>
+ </header>
+ <header>
+ <name>Accept-Encoding</name>
+ <value>*</value>
+ </header>
+ </headers>
+ </put>
+ </httpConfiguration>
+ </configuration>
+ </server>
+ [...]
+ </servers>
+ [...]
+</settings></pre></div></div><div class="section"><h3>Fine-Tuning HttpClient Parameters<a name="Fine-Tuning_HttpClient_Parameters"></a></h3><p>Going beyond the power of HTTP request parameters, HttpClient provides a host of other configuration options. In most cases, you won't need to customize these. But in case you do, Maven provides access to specify your own fine-grained configuration for HttpClient. Again, you can specify these parameter customizations per-method (HEAD, GET, or PUT), or for all methods of interacting with a given server. For a complete list of supported parameters, see the link[2] in Resources section below.</p><div class="section"><h4>Non-String Parameter Values<a name="Non-String_Parameter_Values"></a></h4><p>Many of the configuration parameters for HttpClient have simple string values; however, there are important exceptions to this. In some cases, you may need to specify boolean, integer, or long values. In others, you may even need to specify
a collection of string values. You can specify these using a simple formatting syntax, as follows:</p><ol style="list-style-type: decimal"><li><b>booleans:</b> <tt>%b,<value></tt></li><li><b>integer:</b> <tt>%i,<value></tt></li><li><b>long:</b> <tt>%l,<value></tt> (yes, that's an 'L', not a '1')</li><li><b>double:</b> <tt>%d,<value></tt></li><li><b>collection of strings:</b> <tt>%c,<value1>,<value2>,<value3>,...</tt>, which could also be specified as:<div class="source"><pre>%c,
+<value1>,
+<value2>,
+<value3>,
+...</pre></div></li></ol><p>As you may have noticed, this syntax is similar to the format-and-data strategy used by functions like <tt>sprintf()</tt> in many languages. The syntax has been chosen with this similarity in mind, to make it a little more intuitive to use.</p></div><div class="section"><h4>Example: Using Preemptive Authentication<a name="Example:_Using_Preemptive_Authentication"></a></h4><p>Using the above syntax, we can configure preemptive authentication for PUT requests using the boolean HttpClient parameter <tt>http.authentication.preemptive</tt>, like this:</p><div class="source"><pre><settings>
+ <servers>
+ <server>
+ <id>my-server</id>
+ <configuration>
+ <httpConfiguration>
+ <put>
+ <params>
+ <param>
+ <name>http.authentication.preemptive</name>
+ <value>%b,true</value>
+ </param>
+ </params>
+ </put>
+ </httpConfiguration>
+ </configuration>
+ </server>
+ </servers>
+</settings></pre></div></div><div class="section"><h4>Ignoring Cookies<a name="Ignoring_Cookies"></a></h4><p>Like the example above, telling the HttpClient to ignore cookies for all methods of request is a simple matter of configuring the <tt>http.protocol.cookie-policy</tt> parameter (it uses a regular string value, so no special syntax is required):</p><div class="source"><pre><settings>
+ <servers>
+ <server>
+ <id>my-server</id>
+ <configuration>
+ <httpConfiguration>
+ <all>
+ <params>
+ <param>
+ <name>http.protocol.cookie-policy</name>
+ <value>ignore</value>
+ </param>
+ </params>
+ </all>
+ </httpConfiguration>
+ </configuration>
+ </server>
+ </servers>
+</settings></pre></div><p>The configuration above can be useful in cases where the repository is using cookies - like the session cookies that are often mistakenly turned on or left on in appservers - alongside HTTP redirection. In these cases, it becomes far more likely that the cookie issued by the appserver will use a <tt>Path</tt> that is inconsistent with the one used by the client to access the server. If you have this problem, and know that you don't need to use this session cookie, you can ignore cookies from this server with the above configuration.</p></div></div><div class="section"><h3>Support for General-Wagon Configuration Standards<a name="Support_for_General-Wagon_Configuration_Standards"></a></h3><p>It should be noted that configuration options previously available in the HttpClient-driven HTTP wagon are still supported in addition to this new, fine-grained approach. These include the configuration of HTTP headers and connection timeouts. Let's examine
each of these briefly:</p><div class="section"><h4>HTTP Headers<a name="HTTP_Headers"></a></h4><p>In all HTTP Wagon implementations, you can add your own HTTP headers like this:</p><div class="source"><pre><settings>
+ <servers>
+ <server>
+ <id>my-server</id>
+ <configuration>
+ <httpHeaders>
+ <httpHeader>
+ <name>Foo</name>
+ <value>Bar</value>
+ </httpHeader>
+ </httpHeaders>
+ </configuration>
+ </server>
+ </servers>
+</settings></pre></div><p>It's important to understand that the above approach doesn't allow you to turn off all of the default HTTP headers; nor does it allow you to specify headers on a per-method basis. However, this configuration remains available in both the lightweight and httpclient-based Wagon implementations.</p></div><div class="section"><h4>Connection Timeouts<a name="Connection_Timeouts"></a></h4><p>All wagon implementations that extend the <tt>AbstractWagon</tt> class, including those for SCP, HTTP, FTP, and more, allow the configuration of a connection timeout, to allow the user to tell Maven how long to wait before giving up on a connection that has not responded. This option is preserved in the HttpClient-based wagon, but this wagon also provides a fine-grained alternative configuration that can allow you to specify timeouts per-method for a given server. The old configuration option - which is still supported - looks like this:</p><div class="source"><
pre><settings>
+ <servers>
+ <server>
+ <id>my-server</id>
+ <configuration>
+ <timeout>6000</timeout> <!-- milliseconds -->
+ </configuration>
+ </server>
+ </servers>
+</settings></pre></div><p>...while the new configuration option looks more like this:</p><div class="source"><pre><settings>
+ <servers>
+ <server>
+ <id>my-server</id>
+ <configuration>
+ <httpConfiguration>
+ <put>
+ <connectionTimeout>10000</connectionTimeout> <!-- milliseconds -->
+ </put>
+ </httpConfiguration>
+ </configuration>
+ </server>
+ </servers>
+</settings></pre></div><p>If all you need is a per-server timeout configuration, you still have the option to use the old <tt><timeout></tt> parameter. If you need to separate timeout preferences according to HTTP method, you can use one more like that specified directly above.</p></div><div class="section"><h4>Read time out<a name="Read_time_out"></a></h4><p>With Wagon 2.0 and Apache Maven 3.0.4, a default timeout of 30 minutes comes by default. If you want to change this value, you can add the following setup in your settings:</p><div class="source"><pre><settings>
+ <servers>
+ <server>
+ <id>my-server</id>
+ <configuration>
+ <httpConfiguration>
+ <put>
+ <readTimeout>120000</readTimeout> <!-- milliseconds -->
+ </put>
+ </httpConfiguration>
+ </configuration>
+ </server>
+ </servers>
+</settings></pre></div></div></div><div class="section"><h3>Resources<a name="Resources"></a></h3><ol style="list-style-type: decimal"><li><a class="externalLink" href="http://hc.apache.org/httpclient-3.x/">HttpClient website</a></li><li><a class="externalLink" href="http://hc.apache.org/httpclient-3.x/preference-api.html">HttpClient preference architecture and configuration guide</a></li><li><a href="./guide-wagon-providers.html">Guide to Wagon Providers</a></li><li><a class="externalLink" href="http://maven.apache.org/wagon/wagon-providers/wagon-http/">Wagon Http</a></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/guides/mini/guide-ide-eclipse.html
==============================================================================
--- websites/staging/maventest/trunk/content/guides/mini/guide-ide-eclipse.html (added)
+++ websites/staging/maventest/trunk/content/guides/mini/guide-ide-eclipse.html Thu Mar 1 16:35:39 2012
@@ -0,0 +1,269 @@
+<!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 using Eclipse with Maven 2.x</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="Bernd Mau, mau@hhla.de" />
+ <meta name="Date-Creation-yyyymmdd" content="20100121" />
+ <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 using Eclipse with Maven 2.x
+ </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="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">
+ <div class="section"><h2>Guide to using Eclipse with Maven 2.x<a name="Guide_to_using_Eclipse_with_Maven_2.x"></a></h2><p>This mini guide explains howto use Maven 2 in Eclipse IDE.</p><ul><li><a href="#Maven_2_repository">Maven 2 repository</a></li><li><a href="#Maven_as_an_external_tool">Maven as an external tool</a></li><li><a href="#Simple_Project">Simple Project</a></li><li><a href="#Multiple_Module_Project">Multiple Module Project</a></li></ul><div class="section"><h3><a name="Maven_2_repository">Maven 2 repository</a></h3><p>Eclipse needs to know the path to the local maven repository. Therefore the classpath variable <i>M2_REPO</i> has to be set. Execute the following command:</p><div class="source"><pre>
+mvn -Declipse.workspace=<path-to-eclipse-workspace> eclipse:add-maven-repo
+</pre></div><p>You can also define a new classpath variable inside eclipse: From the menu bar, select Window > Preferences. Select the Java > Build Path > Classpath Variables page.</p><p><b>Issue:</b> The command does not work. Aside from it should not require a POM.</p></div><div class="section"><h3><a name="Maven_as_an_external_tool">Maven as an external tool</a></h3><p>You might want to execute some maven goals from inside eclipse. This is possible by configuring an external launcher. It is best practice to prepare eclipse by adding a variable, which points to your local maven excutable (mvn.bat/mvn). From the menu bar, select Window > Preferences. Select the Run/Debug > String Substitution. Add a new variable e.g. <i>maven_exec</i>. When you set up a new external launcher (from the menu bar, select Run > External Tools. Select Program) you can refer to <i>maven_exec</i> in the location field. Furhtermore refer to <i>project_loc</i> as the working direct
ory and specify the maven goals of your choice as arguments, e.g. <i>eclipse:eclipse</i>. For further information please refer to the eclipse help.</p><p><b>Issue:</b> Would be nice, if the plugin generates the variable and a runner.</p></div><div class="section"><h3><a name="Simple_Project">Simple Project</a></h3><p>If you have a simple java project which is made up of only one module, using eclipse is very simple. To generate the eclipse project files from your POM you execute the following command:</p><div class="source"><pre>
+mvn eclipse:eclipse
+</pre></div><p>If you have created or checked out the project with eclipse, you only have to refresh the project in your workspace. Otherwise you have to import the project into your eclipse workspace (From the menu bar, select File >Import >Existing Projects into Workspace). In the latter case the project (directory) should not be located in your workspace, because eclipse might come into trouble, especially if you want to use eclipse as the scm client.</p></div><div class="section"><h3><a name="Multiple_Module_Project">Multiple Module Project</a></h3><p>Due to the workspace idea many eclipse users are used to a flat layout and therefore want to keep this structure, which is possible but not recommended. Actually, the only reason for a <a href="#Flat_Project_Layout">flat multiple module project layout</a> is the possibility to checkout and edit the parent POM without checking out the whole project. The following sample shows how to handle maven multiple module project
s with eclipse while keeping the <a class="externalLink" href="http://maven.apache.org/guides/mini/guide-multiple-modules.html">recommended hierachical project layout</a>.</p><div class="section"><h4><a name="Step_by_Step_from_Scratch">Step by Step from Scratch</a></h4><p>Supposing eclipse is your favorite SCM client, this step by step example shows how to set up a new mutiple module project.</p><ol style="list-style-type: decimal"><li>Set up a new eclipse workspace called <i>step-by-step</i> and add the <i>M2_REPO</i> classpath variable as <a href="#Maven_2_repository">described above</a>.</li><li>Open the command line shell and change to the newly created workspace directory.</li><li>From the command line change to newly created <i>step-by-step</i> workspace and create a new maven project using the archetype plugin.<div class="source"><pre>mvn archetype:generate -DgroupId=guide.ide.eclipse -DartifactId=guide-ide-eclipse</pre></div></li><li>Create a new simple project <i>gu
ide-ide-eclipse</i> inside the <i>step-by-step</i> workspace with eclipse (From the menu bar, select File >New >Project. Select Simple >Project). Eclipse will create a simple <i>.project</i>-file for your <i>guide-ide-eclipse</i>-project and you should be able to see the <i>pom.xml</i>-file.</li><li>Delete the <i>src</i>-folder and open the <i>pom.xml</i>-file to change the packaging of your parent project to <i>pom</i><div class="source"><pre> <packaging>pom</packaging></pre></div><p><b>Issue:</b> mvn eclipse:eclipse may should generate a simple <i>.project</i>-file for pom types.</p></li><li>From the command line change to the <i>guide-ide-eclipse</i> project directory and create some modules.<div class="source"><pre>cd guide-ide-eclipse
+mvn archetype:generate -DgroupId=guide.ide.eclipse -DartifactId=guide-ide-eclipse-site
+mvn archetype:generate -DgroupId=guide.ide.eclipse.core -DartifactId=guide-ide-eclipse-core
+mvn archetype:generate -DgroupId=guide.ide.eclipse.module1 -DartifactId=guide-ide-eclipse-module1</pre></div></li><li>Add the newly created modules to your parent pom.<div class="source"><pre> <modules>
+ <module>guide-ide-eclipse-site</module>
+ <module>guide-ide-eclipse-core</module>
+ <module>guide-ide-eclipse-module1</module>
+ </modules></pre></div></li><li>Add the parent to the POMs of the new modules:<div class="source"><pre> <parent>
+ <groupId>guide.ide.eclipse</groupId>
+ <artifactId>guide-ide-eclipse</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ </parent></pre></div></li><li>Add dependency from <i>module1</i> to the <i>core</i>-module:<div class="source"><pre> <dependency>
+ <groupId>guide.ide.eclipse.core</groupId>
+ <artifactId>guide-ide-eclipse-core</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ </dependency></pre></div></li><li>Install the project in your local repository and generate the eclipse files:<div class="source"><pre>mvn install
+mvn eclipse:eclipse</pre></div></li><li>Check in your project using the eclipse team support (select from the context menu Team >Share Project). <i>Note:</i> Don not check in the generated eclipse files. If you use CVS you should have a <i>.cvsignore</i>-file with the following entries for each module:<div class="source"><pre>target
+.classpath
+.project
+.wtpmodules</pre></div><p>Even the parent project should have this <i>.cvsignore</i>-file. Eclipse will automatically generate a new simple <i>.project</i>-file when you check out the project from the repository.</p><p><b>Issue:</b> Plugin should optionally generate the <i>.cvsignore</i>-files.</p></li></ol><p>From now on you have different options to proceed. If you are working on all modules simultanously and you rather have eclipse project dependencies than binary dependencies, you should set up a new workspace and import all projects form <i>step-by-step/guide-ide-eclipse</i>. Note, you have to delete the <i>.project</i>-file of your parent project before. The result is equals to checking out the whole project from the command line, running <i>mvn eclipse:eclipse</i> and finally importing the projects into your eclipse workspace. In both cases you will be able to synchronize your changes using eclipse.</p><p>In case of large projects whith many people it can be quite ted
ious to check out all modules and keep them up to date. Especially if you are only interested in one or two modules. In this case using binary dependencies is much more comfortable. Just check out the modules you want to work on with eclipse and run <i>mvn eclipse:eclipse</i> for each module (see also <a href="#Maven_as_an_external_tool">Maven as an external tool</a>). Of course all referenced artifacts have to be available from your maven repository.</p><p><b>Issue:</b> The maven-eclipse-plugin should optionally generate project dependencies for those modules which are available in the workspace.</p></div><div class="section"><h4><a name="Flat_Project_Layout">Flat Project Layout</a></h4><p>It is possible to move the parent POM in its own directory on the same level with the referenced modules.</p><ol style="list-style-type: decimal"><li>Create a new directory under <i>guide-ide-eclipse</i> called <i>guide-ide-eclipse-project</i> and move the parent POM to it.</li><li>Change
the module references in the parent POM to:<div class="source"><pre> <modules>
+ <module>../guide-ide-eclipse-site</module>
+ <module>../guide-ide-eclipse-core</module>
+ <module>../guide-ide-eclipse-module1</module>
+ </modules></pre></div></li></ol><p><b>Issue:</b> The release plugin does not support the flat structure (<a class="externalLink" href="http://jira.codehaus.org/browse/MRELEASE-6">MRELEASE-6</a>)</p></div></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/guides/mini/guide-ide-idea.html
==============================================================================
--- websites/staging/maventest/trunk/content/guides/mini/guide-ide-idea.html (added)
+++ websites/staging/maventest/trunk/content/guides/mini/guide-ide-idea.html Thu Mar 1 16:35:39 2012
@@ -0,0 +1,243 @@
+<!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 using IDEA with Maven 2.x</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="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>
+ >
+ Guide to using IDEA with Maven 2.x
+ </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="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">
+ <div class="section"><h2>Guide to using IDEA with Maven 2.x <a name="Guide_to_using_IDEA_with_Maven_2.x"></a></h2><p>To generate the IDEA project files from your POM you execute the following command:</p><div class="source"><pre>
+mvn idea:idea
+</pre></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/guides/mini/guide-ide-netbeans/Context_Menu.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Context_Menu.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Generate_Site.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Generate_Site.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Open_Project.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Open_Project.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Project_Opened.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Project_Opened.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Refresh_Project.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Refresh_Project.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Refreshed_Context_Menu.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Refreshed_Context_Menu.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Run_Build_Main_Project.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Run_Build_Main_Project.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Run_Clean_Main_Project.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Run_Clean_Main_Project.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Window_Files.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/Window_Files.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/guide-ide-netbeans.html
==============================================================================
--- websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/guide-ide-netbeans.html (added)
+++ websites/staging/maventest/trunk/content/guides/mini/guide-ide-netbeans/guide-ide-netbeans.html Thu Mar 1 16:35:39 2012
@@ -0,0 +1,350 @@
+<!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 Using Maven 2 in NetBeans 4.0 (4.1 and 5.0)</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="Raphaël Piéroni" />
+ <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 Using Maven 2 in NetBeans 4.0 (4.1 and 5.0)
+ </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="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">
+ <div class="section"><h2>Using Maven 2 in NetBeans 4.0 (4.1 and 5.0)<a name="Using_Maven_2_in_NetBeans_4.0_4.1_and_5.0"></a></h2><p>This mini guide explain by examples how to use Maven 2 in NetBeans IDE.</p><p>To use Maven 2 in NetBeans you have to follow these steps:</p><ul><li><a href="#RetreiveCreate_the_Maven_2_project">Retrieve/Create the Maven 2 project.</a></li><li><a href="#Launch_Maven_2_in_command_line_using_the_netbeans-freeform_plugin">Launch Maven 2 in command line using the netbeans-freeform plugin.</a></li><li><a href="#Open_the_project_with_NetBeans">Open the project with NetBeans.</a></li><li><a href="#Build_the_project_and_launch_other_Maven_goals">Build the project and launch other Maven goals.</a></li><li><a href="#Edit_properties_of_the_plugin">Edit properties of the plugin.</a></li><li><a href="#Refresh_the_project_view">Refresh the project view.</a></li><li><a href="#Build_the_Maven_2_site">Build the Maven 2 site.</a></li></ul><div class="secti
on"><h3><a name="RetrieveCreate_the_Maven_2_project">Retrieve/Create the Maven 2 project</a></h3><p>This guide assume the project is created using the archetype plugin. You can also checkout the Maven 2 project using your versionning system.</p><div><pre>[maven-user@mini-guide examples]$ mvn archetype:generate -DarchetypeArtifactId=maven-archetype-quickstart -DartifactId=demoquickstart -DgroupId=demoquickstart
+
+[INFO] Searching repository for plugin with prefix: 'archetype'.
+[INFO] ----------------------------------------------------------------------------
+[INFO] Building Maven Default Project
+[INFO] task-segment: [archetype:generate] (aggregator-style)
+[INFO] ----------------------------------------------------------------------------
+[INFO] Setting property: classpath.resource.loader.class => 'org.codehaus.plexus.velocity.ContextClassLoaderResourceLoader'.
+[INFO] Setting property: resource.loader => 'classpath'.
+[INFO] **************************************************************
+[INFO] Starting Jakarta Velocity v1.4
+[INFO] RuntimeInstance initializing.
+[INFO] Default Properties File: org/apache/velocity/runtime/defaults/velocity.properties
+[INFO] Default ResourceManager initializing. (class org.apache.velocity.runtime.resource.ResourceManagerImpl)
+[INFO] Resource Loader Instantiated: org.codehaus.plexus.velocity.ContextClassLoaderResourceLoader
+[INFO] ClasspathResourceLoader : initialization starting.
+[INFO] ClasspathResourceLoader : initialization complete.
+[INFO] ResourceCache : initialized. (class org.apache.velocity.runtime.resource.ResourceCacheImpl)
+[INFO] Default ResourceManager initialization complete.
+[INFO] Loaded System Directive: org.apache.velocity.runtime.directive.Literal
+[INFO] Loaded System Directive: org.apache.velocity.runtime.directive.Macro
+[INFO] Loaded System Directive: org.apache.velocity.runtime.directive.Parse
+[INFO] Loaded System Directive: org.apache.velocity.runtime.directive.Include
+[INFO] Loaded System Directive: org.apache.velocity.runtime.directive.Foreach
+[INFO] Created: 20 parsers.
+[INFO] Velocimacro : initialization starting.
+[INFO] Velocimacro : adding VMs from VM library template : VM_global_library.vm
+[ERROR] ResourceManager : unable to find resource 'VM_global_library.vm' in any resource loader.
+[INFO] Velocimacro : error using VM library template VM_global_library.vm : org.apache.velocity.exception.ResourceNotFoundException: Unable to find resource 'VM_global_library.vm'
+[INFO] Velocimacro : VM library template macro registration complete.
+[INFO] Velocimacro : allowInline = true : VMs can be defined inline in templates
+[INFO] Velocimacro : allowInlineToOverride = false : VMs defined inline may NOT replace previous VM definitions
+[INFO] Velocimacro : allowInlineLocal = false : VMs defined inline will be global in scope if allowed.
+[INFO] Velocimacro : messages on : VM system will output logging messages
+[INFO] Velocimacro : autoload off : VM system will not automatically reload global library macros
+[INFO] Velocimacro : initialization complete.
+[INFO] Velocity successfully started.
+[INFO] [archetype:generate]
+[INFO] Defaulting package to group ID: demoquickstart
+[INFO] artifact org.apache.maven.archetypes:maven-archetype-quickstart: checking for updates from central
+[INFO] ----------------------------------------------------------------------------
+[INFO] Using following parameters for creating Archetype: maven-archetype-quickstart:RELEASE
+[INFO] ----------------------------------------------------------------------------
+[INFO] Parameter: groupId, Value: demoquickstart
+[INFO] Parameter: outputDirectory, Value: /demos/demoquickstart
+[INFO] Parameter: packageName, Value: demoquickstart
+[INFO] Parameter: package, Value: demoquickstart
+[INFO] Parameter: version, Value: 1.0-SNAPSHOT
+[INFO] Parameter: artifactId, Value: demoquickstart
+[INFO] ResourceManager : found archetype-resources/pom.xml with loader org.codehaus.plexus.velocity.ContextClassLoaderResourceLoader
+[INFO] ResourceManager : found archetype-resources/src/main/java/App.java with loader org.codehaus.plexus.velocity.ContextClassLoaderResourceLoader
+[INFO] ResourceManager : found archetype-resources/src/test/java/AppTest.java with loader org.codehaus.plexus.velocity.ContextClassLoaderResourceLoader
+[INFO] Archetype created in dir: /demos/demoquickstart
+[INFO] ----------------------------------------------------------------------------
+[INFO] BUILD SUCCESSFUL
+[INFO] ----------------------------------------------------------------------------
+[INFO] Total time: 2 seconds
+[INFO] Finished at: Tue Oct 11 21:59:22 CEST 2005
+[INFO] Final Memory: 3M/7M
+[INFO] ----------------------------------------------------------------------------</pre></div></div><div class="section"><h3><a name="Launch_Maven_2_in_command_line_using_the_netbeans-freeform_plugin">Launch Maven 2 in command line using the netbeans-freeform plugin</a></h3><p>After having retrieved the Maven 2 project, you have to enable the project to be seen as a NetBeans 4.0, 4.1 or 5.0 project using the NetBeans Freeform project type.</p><p>To enable the project, use the netbeans-freeform plugin for Maven 2.</p><div><pre>[maven-user@mini-guide demoquickstart]$ mvn netbeans-freeform:generate-netbeans-project
+[INFO] Searching repository for plugin with prefix: 'netbeans-freeform'.
+[INFO] ----------------------------------------------------------------------------
+[INFO] Building Maven Quick Start Archetype
+[INFO] task-segment: [netbeans-freeform:generate-netbeans-project]
+[INFO] ----------------------------------------------------------------------------
+[INFO] Preparing netbeans-freeform:generate-netbeans-project
+[INFO] [netbeans-freeform:generate-netbeans-project]
+[INFO] JarAnalyser found
+[INFO] The project 'Maven Quick Start Archetype' is analysed.
+[INFO] The file 'nbproject/project.xml' is created.
+[INFO] The file 'nbproject/mavencall.xml' is created.
+[INFO] The file 'nbproject/project.properties' is created.
+[INFO] ----------------------------------------------------------------------------
+[INFO] BUILD SUCCESSFUL
+[INFO] ----------------------------------------------------------------------------
+[INFO] Total time: < 1 second
+[INFO] Finished at: Tue Oct 11 22:12:30 CEST 2005
+[INFO] Final Memory: 1M/3M
+[INFO] ----------------------------------------------------------------------------</pre></div><p>The netbeans-freeform plugin creates one directory and three files by reading the Maven 2 project descriptor:</p><ul><li>The <tt>nbproject</tt> directory holds the NetBeans project descriptor. </li><li>The <tt><project.xml</tt> file is the NetBeans Freeform project descriptor. </li><li>The <tt>mavencall.xml</tt> holds the Ant calls which execute Maven 2, as NetBeans uses Ant as its build tool. </li><li>The <tt>project.properties</tt> files holds the two properties: <tt>local.repository</tt> which is the absolute path to the Maven 2 local repository and <tt>project.directory</tt> which is the absolute path to the project directory.</li></ul></div><div class="section"><h3><a name="Open_the_project_with_NetBeans">Open the project with NetBeans</a></h3><p>Now that the Maven 2 project is eneabled for use in NetBeans, open your NetBeans IDE. Then open the project (Ctrl+Maj+O). </p>
<p>Here is the <i>Open Project</i> window.</p><img src="Open_Project.png" alt="Open Project" /><p>And here are:</p><p>The <i>Projects Window</i> with the opened project.</p><img src="Project_Opened.png" alt="Project Opened" /><p>The project's <i>Context Menu</i> of the opened project.</p><img src="Context_Menu.png" alt="Context Menu" /><p>And the <i>Files Window</i> with the opened project.</p><img src="Window_Files.png" alt="Files Window" /></div><div class="section"><h3><a name="Build_the_project_and_launch_other_Maven_goals">Build the project and launch other Maven goals</a></h3><p>It is now time to try the first execution of Maven 2 from within NetBeans. Try the <i>Build Main Project</i> NetBeans action (F11). You see the Maven 2 execution of the <tt>package</tt> lifecycle goal.</p><img src="Run_Build_Main_Project.png" alt="Run Build Main Project" /><p>You can also call the <i>Clean Project</i> NetBeans action which is mapped to the <tt>clean</tt> Maven2 goal.</p><img sr
c="Run_Clean_Main_Project.png" alt="Run Clean Main Project" /></div><div class="section"><h3><a name="Edit_properties_of_the_plugin">Edit properties of the plugin</a></h3><p>Now you can add some additionnal views in your <i>Projects</i> window in NetBeans. Like an additionnal goal in the context menu. </p><div><pre><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/xsd/maven-4.0.0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>demoquickstart</groupId>
+ <artifactId>demoquickstart</artifactId>
+ <packaging>jar</packaging>
+ <version>1.0-SNAPSHOT</version>
+ <name>Maven Quick Start Archetype</name>
+ <url>http://maven.apache.org</url>
+ <dependencies>
+ <dependency>
+ <groupId>junit</groupId>
+ <artifactId>junit</artifactId>
+ <version>3.8.1</version>
+ <scope>test</scope>
+ </dependency>
+ </dependencies>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.codehaus.mojo</groupId>
+ <artifactId>netbeans-freeform-maven-plugin</artifactId>
+ <version>2.0</version>
+ <configuration>
+ <additionalGoals>source:jar</additionalGoals>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+</project></pre></div><p>You can also configure some additionnal files and folders in the <i>Projects</i> window.</p><p>The last option is to create the <tt>nbproject</tt> folder and its content in another directory than in the Maven 2 project's one.</p><p>The full configuration can be found at <a class="externalLink" href="http://mojo.codehaus.org/netbeans-freeform-maven-plugin/">http://mojo.codehaus.org/netbeans-freeform-maven-plugin/</a>.</p></div><div class="section"><h3><a name="Refresh_the_project_view">Refresh the project view</a></h3><p>To refresh the Project view in NetBeans accordingly to the new configuration added to the Maven 2 project descriptor. Just right-clic the project in the Projects window and choose the <i>Refresh Project</i> action.</p><img src="Refresh_Project.png" alt="Refresh Project" /><p>Here is the resulting refreshed Context Menu.</p><img src="Refreshed_Context_Menu.png" alt="Refreshed Context Menu" /></div><div class="section"><h3><a name
="Build_the_Maven_2_site">Build the Maven 2 site</a></h3><p>You can call The <i>Generate Javadoc for Project</i> NetBeans action which is mapped to the <tt>site</tt> Maven 2 goal, here in the Maven site archetype.</p><img src="Generate_Site.png" alt="Generate Site" /></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>