You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by ol...@apache.org on 2012/12/04 12:35:47 UTC
svn commit: r840703 [32/35] - in
/websites/production/maventest/content/plugins: maven-assembly-plugin/
maven-compiler-plugin/ maven-compiler-plugin/apidocs/
maven-compiler-plugin/apidocs/org/apache/maven/plugin/compiler/
maven-compiler-plugin/apidocs/...
Added: websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/configuring-classpath.html
==============================================================================
--- websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/configuring-classpath.html (added)
+++ websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/configuring-classpath.html Tue Dec 4 11:35:30 2012
@@ -0,0 +1,273 @@
+<!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 Aug 25, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Configuring the Classpath</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+ <style>body{padding-top: 20px;}</style>
+
+ <script type="text/javascript" src="../js/apache-maven-fluido.min.js"></script>
+
+
+
+ <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript" src="http://www.google-analytics.com/urchin.js"></script>
+
+
+ <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+
+ <meta name="author" content="Pascal Lambert" />
+ <meta name="Date-Creation-yyyymmdd" content="20100109" />
+ <meta name="Date-Revision-yyyymmdd" content="20120825" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body>
+
+
+ <div class="container-fluid">
+ <div id="banner">
+ <div class="pull-left"> <a href="../../../" id="bannerLeft">
+ <img src="../../../images/apache-maven-project.png" alt="Maven Surefire Plugin"/>
+ </a>
+ </div>
+ <div class="pull-right"> <div id="bannerRight">
+ <img src="../../../images/maventxt_logo_200.gif" alt="Maven Surefire Plugin"/>
+ </div>
+ </div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+
+
+ <li class="">
+ <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../../../index.html" title="Maven">Maven</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../../../surefire/" title="Surefire">Surefire</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../" title="Maven Surefire Plugin">Maven Surefire Plugin</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">Configuring the Classpath</li>
+
+
+ <li id="publishDate" class="pull-right">Last Published: 2012-08-25</li> <li class="divider pull-right">|</li>
+ <li id="projectVersion" class="pull-right">Version: 2.12.3</li>
+ </ul>
+ </div>
+
+ <div id="leftColumn" class="sidebar">
+ <div class="well">
+
+
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="Introduction">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../plugin-info.html" title="Goals">Goals</a>
+ </li>
+ <li class="none">
+ <a href="../usage.html" title="Usage">Usage</a>
+ </li>
+ <li class="none">
+ <a href="../featurematrix.html" title="Feature matrix">Feature matrix</a>
+ </li>
+ <li class="none">
+ <a href="../api.html" title="API">API</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html" title="FAQ">FAQ</a>
+ </li>
+ </ul>
+ <h5>Examples</h5>
+ <ul>
+ <li class="none">
+ <a href="../examples/testng.html" title="Using TestNG">Using TestNG</a>
+ </li>
+ <li class="none">
+ <a href="../examples/junit.html" title="Using JUnit">Using JUnit</a>
+ </li>
+ <li class="none">
+ <a href="../examples/skipping-test.html" title="Skipping Tests">Skipping Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/inclusion-exclusion.html" title="Inclusions and Exclusions of Tests">Inclusions and Exclusions of Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/single-test.html" title="Running a Single Test">Running a Single Test</a>
+ </li>
+ <li class="none">
+ <a href="../examples/class-loading.html" title="Class Loading Issues">Class Loading Issues</a>
+ </li>
+ <li class="none">
+ <a href="../examples/debugging.html" title="Debugging Tests">Debugging Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/system-properties.html" title="System Properties">System Properties</a>
+ </li>
+ <li class="none">
+ <strong>Configuring the Classpath</strong>
+ </li>
+ <li class="none">
+ <a href="../examples/providers.html" title="Selecting providers">Selecting providers</a>
+ </li>
+ </ul>
+ <h5>Developer Center</h5>
+ <ul>
+ <li class="none">
+ <a href="../developing.html" title="Developing">Developing</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../../ant-tasks/index.html" title="Ant Tasks">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../../archetype/index.html" title="Archetype">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../../doxia/index.html" title="Doxia">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../../jxr/index.html" title="JXR">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../../maven-1.x/index.html" title="Maven 1.x">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../../../index.html" title="Maven 2 & 3">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../../../plugins/index.html" title="Plugins">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../../scm/index.html" title="SCM">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../../shared/index.html" title="Shared Components">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../../skins/index.html" title="Skins">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../../index.html" title="Surefire">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../../wagon/index.html" title="Wagon">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+ </li>
+ </ul>
+
+
+
+
+ <div id="poweredBy">
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+ </a>
+ </div>
+ </div>
+ </div>
+
+ <div id="bodyColumn" class="content">
+ <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/refer
ences/apt-format.html --><div class="section"><h2>The Default Classpath<a name="The_Default_Classpath"></a></h2><p>The surefire plugin builds the test classpath in the following order:</p><ol style="list-style-type: decimal"><li>The <a href="../test-mojo.html#testClassesDirectory">test-classes</a> directory</li><li>The <a href="../test-mojo.html#classesDirectory">classes</a> directory</li><li>The project dependencies</li><li>Additional classpath elements</li></ol></div><div class="section"><h2>Additional Classpath Elements<a name="Additional_Classpath_Elements"></a></h2><p>If you need to put more stuff in your classpath when Surefire executes (e.g some funky resources or a container specific JAR), we normally recommend you add it to your classpath as a dependency. Consider deploying shared jars to a private remote repository for your organization.</p><p>But, if you must, you can use the <tt>additionalClasspathElements</tt> element to add custom resources/jars to your classpa
th. This will be treated as an absolute file system path, so you may want use ${basedir} or another property combined with a relative path. Note that additional classpath elements are added to the end of the classpath, so you cannot use these to override project dependencies or resources.</p><div class="source"><pre class="prettyprint"><project>
+ [...]
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.12.3</version>
+ <configuration>
+ <additionalClasspathElements>
+ <additionalClasspathElement>path/to/additional/resources</additionalClasspathElement>
+ <additionalClasspathElement>path/to/additional/jar</additionalClasspathElement>
+ </additionalClasspathElements>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ [...]
+</project></pre></div></div><div class="section"><h2>Removing Dependency Classpath Elements<a name="Removing_Dependency_Classpath_Elements"></a></h2><p>Dependencies can be removed from the test classpath using the parameters <tt>classpathDependencyExcludes</tt> and <tt>classpathDependencyScopeExclude</tt>. A list of specific dependencies can be removed from the classpath by specifying the groupId:artifactId to be removed.</p><div class="source"><pre class="prettyprint"><project>
+ [...]
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.12.3</version>
+ <configuration>
+ <classpathDependencyExcludes>
+ <classpathDependencyExcludes>org.apache.commons:commons-email</classpathDependencyExcludes>
+ </classpathDependencyExcludes>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ [...]
+</project></pre></div><p>Dependencies under a certain scope can be removed from the classpath using <tt>classpathDependencyScopeExclude</tt>. The valid values for the dependency scope exclude are defined by <tt>org.apache.maven.artifact.resolver.filter.ScopeArtifactFilter</tt>.</p><ul><li><b>compile</b> - system, provided, compile</li><li><b>runtime</b> - compile, runtime</li><li><b>test</b> - system, provided, compile, runtime, test<div class="source"><pre class="prettyprint"><project>
+ [...]
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.12.3</version>
+ <configuration>
+ <classpathDependencyScopeExclude>runtime</classpathDependencyScopeExclude>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ [...]
+</project></pre></div></li></ul></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container-fluid">
+ <div class="row span16">Copyright © 2004-2012
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.
+
+ </div>
+
+ </div>
+ </footer>
+ </body>
+</html>
Added: websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/debugging.html
==============================================================================
--- websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/debugging.html (added)
+++ websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/debugging.html Tue Dec 4 11:35:30 2012
@@ -0,0 +1,223 @@
+<!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 Aug 25, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Debugging Tests</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+ <style>body{padding-top: 20px;}</style>
+
+ <script type="text/javascript" src="../js/apache-maven-fluido.min.js"></script>
+
+
+
+ <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript" src="http://www.google-analytics.com/urchin.js"></script>
+
+
+ <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+
+ <meta name="author" content="Dan Fabulich" />
+ <meta name="Date-Creation-yyyymmdd" content="20100109" />
+ <meta name="Date-Revision-yyyymmdd" content="20120825" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body>
+
+
+ <div class="container-fluid">
+ <div id="banner">
+ <div class="pull-left"> <a href="../../../" id="bannerLeft">
+ <img src="../../../images/apache-maven-project.png" alt="Maven Surefire Plugin"/>
+ </a>
+ </div>
+ <div class="pull-right"> <div id="bannerRight">
+ <img src="../../../images/maventxt_logo_200.gif" alt="Maven Surefire Plugin"/>
+ </div>
+ </div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+
+
+ <li class="">
+ <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../../../index.html" title="Maven">Maven</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../../../surefire/" title="Surefire">Surefire</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../" title="Maven Surefire Plugin">Maven Surefire Plugin</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">Debugging Tests</li>
+
+
+ <li id="publishDate" class="pull-right">Last Published: 2012-08-25</li> <li class="divider pull-right">|</li>
+ <li id="projectVersion" class="pull-right">Version: 2.12.3</li>
+ </ul>
+ </div>
+
+ <div id="leftColumn" class="sidebar">
+ <div class="well">
+
+
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="Introduction">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../plugin-info.html" title="Goals">Goals</a>
+ </li>
+ <li class="none">
+ <a href="../usage.html" title="Usage">Usage</a>
+ </li>
+ <li class="none">
+ <a href="../featurematrix.html" title="Feature matrix">Feature matrix</a>
+ </li>
+ <li class="none">
+ <a href="../api.html" title="API">API</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html" title="FAQ">FAQ</a>
+ </li>
+ </ul>
+ <h5>Examples</h5>
+ <ul>
+ <li class="none">
+ <a href="../examples/testng.html" title="Using TestNG">Using TestNG</a>
+ </li>
+ <li class="none">
+ <a href="../examples/junit.html" title="Using JUnit">Using JUnit</a>
+ </li>
+ <li class="none">
+ <a href="../examples/skipping-test.html" title="Skipping Tests">Skipping Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/inclusion-exclusion.html" title="Inclusions and Exclusions of Tests">Inclusions and Exclusions of Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/single-test.html" title="Running a Single Test">Running a Single Test</a>
+ </li>
+ <li class="none">
+ <a href="../examples/class-loading.html" title="Class Loading Issues">Class Loading Issues</a>
+ </li>
+ <li class="none">
+ <strong>Debugging Tests</strong>
+ </li>
+ <li class="none">
+ <a href="../examples/system-properties.html" title="System Properties">System Properties</a>
+ </li>
+ <li class="none">
+ <a href="../examples/configuring-classpath.html" title="Configuring the Classpath">Configuring the Classpath</a>
+ </li>
+ <li class="none">
+ <a href="../examples/providers.html" title="Selecting providers">Selecting providers</a>
+ </li>
+ </ul>
+ <h5>Developer Center</h5>
+ <ul>
+ <li class="none">
+ <a href="../developing.html" title="Developing">Developing</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../../ant-tasks/index.html" title="Ant Tasks">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../../archetype/index.html" title="Archetype">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../../doxia/index.html" title="Doxia">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../../jxr/index.html" title="JXR">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../../maven-1.x/index.html" title="Maven 1.x">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../../../index.html" title="Maven 2 & 3">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../../../plugins/index.html" title="Plugins">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../../scm/index.html" title="SCM">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../../shared/index.html" title="Shared Components">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../../skins/index.html" title="Skins">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../../index.html" title="Surefire">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../../wagon/index.html" title="Wagon">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+ </li>
+ </ul>
+
+
+
+
+ <div id="poweredBy">
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+ </a>
+ </div>
+ </div>
+ </div>
+
+ <div id="bodyColumn" class="content">
+ <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/refer
ences/apt-format.html --><div class="section"><h2>Debugging Tests<a name="Debugging_Tests"></a></h2><p>Sometimes you need to debug the tests exactly as Maven ran them. Here's how!</p></div><div class="section"><h2>Forked Tests<a name="Forked_Tests"></a></h2><p>By default, Maven runs your tests in a separate ("forked") process. You can use the <tt>maven.surefire.debug</tt> property to debug your forked tests remotely, like this:</p><div class="source"><pre class="prettyprint">mvn -Dmaven.surefire.debug test</pre></div><p>The tests will automatically pause and await a remote debugger on port 5005. You can then attach to the running tests using Eclipse. You can setup a "Remote Java Application" launch configuration via the menu command "Run" > "Open Debug Dialog..."</p><p>If you need to configure a different port, you may pass a more detailed value. For example, the command below will use port 8000 instead of port 5005.</p><div class="
source"><pre class="prettyprint">mvn -Dmaven.surefire.debug="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 -Xnoagent -Djava.compiler=NONE" test</pre></div></div><div class="section"><h2>Non-forked Tests<a name="Non-forked_Tests"></a></h2><p>You can force Maven not to fork tests by configuring the <tt>forkMode</tt> configuration parameter.</p><div class="source"><pre class="prettyprint">mvn -DforkMode=never test</pre></div><p>Then all you need to do is debug Maven itself. Since Maven 2.0.8, Maven has shipped with a "mvnDebug" shell script that you can use to launch Maven with convenient debugging options:</p><div class="source"><pre class="prettyprint">mvnDebug -DforkMode=never test</pre></div><p>Then you can attach Eclipse to Maven itself, which may be easier/more convenient than debugging the forked executable.</p></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container-fluid">
+ <div class="row span16">Copyright © 2004-2012
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.
+
+ </div>
+
+ </div>
+ </footer>
+ </body>
+</html>
Added: websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/inclusion-exclusion.html
==============================================================================
--- websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/inclusion-exclusion.html (added)
+++ websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/inclusion-exclusion.html Tue Dec 4 11:35:30 2012
@@ -0,0 +1,275 @@
+<!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 Aug 25, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Inclusions and Exclusions of Tests</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+ <style>body{padding-top: 20px;}</style>
+
+ <script type="text/javascript" src="../js/apache-maven-fluido.min.js"></script>
+
+
+
+ <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript" src="http://www.google-analytics.com/urchin.js"></script>
+
+
+ <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+
+ <meta name="author" content="Allan Ramirez" />
+ <meta name="Date-Creation-yyyymmdd" content="20100109" />
+ <meta name="Date-Revision-yyyymmdd" content="20120825" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body>
+
+
+ <div class="container-fluid">
+ <div id="banner">
+ <div class="pull-left"> <a href="../../../" id="bannerLeft">
+ <img src="../../../images/apache-maven-project.png" alt="Maven Surefire Plugin"/>
+ </a>
+ </div>
+ <div class="pull-right"> <div id="bannerRight">
+ <img src="../../../images/maventxt_logo_200.gif" alt="Maven Surefire Plugin"/>
+ </div>
+ </div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+
+
+ <li class="">
+ <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../../../index.html" title="Maven">Maven</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../../../surefire/" title="Surefire">Surefire</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../" title="Maven Surefire Plugin">Maven Surefire Plugin</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">Inclusions and Exclusions of Tests</li>
+
+
+ <li id="publishDate" class="pull-right">Last Published: 2012-08-25</li> <li class="divider pull-right">|</li>
+ <li id="projectVersion" class="pull-right">Version: 2.12.3</li>
+ </ul>
+ </div>
+
+ <div id="leftColumn" class="sidebar">
+ <div class="well">
+
+
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="Introduction">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../plugin-info.html" title="Goals">Goals</a>
+ </li>
+ <li class="none">
+ <a href="../usage.html" title="Usage">Usage</a>
+ </li>
+ <li class="none">
+ <a href="../featurematrix.html" title="Feature matrix">Feature matrix</a>
+ </li>
+ <li class="none">
+ <a href="../api.html" title="API">API</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html" title="FAQ">FAQ</a>
+ </li>
+ </ul>
+ <h5>Examples</h5>
+ <ul>
+ <li class="none">
+ <a href="../examples/testng.html" title="Using TestNG">Using TestNG</a>
+ </li>
+ <li class="none">
+ <a href="../examples/junit.html" title="Using JUnit">Using JUnit</a>
+ </li>
+ <li class="none">
+ <a href="../examples/skipping-test.html" title="Skipping Tests">Skipping Tests</a>
+ </li>
+ <li class="none">
+ <strong>Inclusions and Exclusions of Tests</strong>
+ </li>
+ <li class="none">
+ <a href="../examples/single-test.html" title="Running a Single Test">Running a Single Test</a>
+ </li>
+ <li class="none">
+ <a href="../examples/class-loading.html" title="Class Loading Issues">Class Loading Issues</a>
+ </li>
+ <li class="none">
+ <a href="../examples/debugging.html" title="Debugging Tests">Debugging Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/system-properties.html" title="System Properties">System Properties</a>
+ </li>
+ <li class="none">
+ <a href="../examples/configuring-classpath.html" title="Configuring the Classpath">Configuring the Classpath</a>
+ </li>
+ <li class="none">
+ <a href="../examples/providers.html" title="Selecting providers">Selecting providers</a>
+ </li>
+ </ul>
+ <h5>Developer Center</h5>
+ <ul>
+ <li class="none">
+ <a href="../developing.html" title="Developing">Developing</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../../ant-tasks/index.html" title="Ant Tasks">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../../archetype/index.html" title="Archetype">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../../doxia/index.html" title="Doxia">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../../jxr/index.html" title="JXR">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../../maven-1.x/index.html" title="Maven 1.x">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../../../index.html" title="Maven 2 & 3">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../../../plugins/index.html" title="Plugins">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../../scm/index.html" title="SCM">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../../shared/index.html" title="Shared Components">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../../skins/index.html" title="Skins">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../../index.html" title="Surefire">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../../wagon/index.html" title="Wagon">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+ </li>
+ </ul>
+
+
+
+
+ <div id="poweredBy">
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+ </a>
+ </div>
+ </div>
+ </div>
+
+ <div id="bodyColumn" class="content">
+ <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/refer
ences/apt-format.html --><div class="section"><h2>Inclusions and Exclusions of Tests<a name="Inclusions_and_Exclusions_of_Tests"></a></h2><div class="section"><h3>Inclusions<a name="Inclusions"></a></h3><p>By default, the Surefire Plugin will automatically include all test classes with the following wildcard patterns:</p><ul><li><tt>"**/Test*.java"</tt> - includes all of its subdirectories and all java filenames that start with "Test".</li><li><tt>"**/*Test.java"</tt> - includes all of its subdirectories and all java filenames that end with "Test".</li><li><tt>"**/*TestCase.java"</tt> - includes all of its subdirectories and all java filenames that end with "TestCase".</li></ul><p>If the test classes does not go with the naming convention, then configure Surefire Plugin and specify the tests you want to include.</p><div class="source"><pre class="prettyprint"><project>
+ [...]
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.12.3</version>
+ <configuration>
+ <includes>
+ <include>Sample.java</include>
+ </includes>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ [...]
+</project></pre></div></div><div class="section"><h3>Exclusions<a name="Exclusions"></a></h3><p>There are certain times when some tests are causing the build to fail. Excluding them is one of the best workarounds to continue the build. Exclusions can be done by configuring the <b>excludes</b> property of the plugin.</p><div class="source"><pre class="prettyprint"><project>
+ [...]
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.12.3</version>
+ <configuration>
+ <excludes>
+ <exclude>**/TestCircle.java</exclude>
+ <exclude>**/TestSquare.java</exclude>
+ </excludes>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ [...]
+</project></pre></div></div><div class="section"><h3>Regular expression support<a name="Regular_expression_support"></a></h3><p>An include/exclude pattern can be an ant-style path expression, but regular expressions are also supported through this syntax:</p><div class="source"><pre class="prettyprint"><project>
+ [...]
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.12.3</version>
+ <configuration>
+ <includes>
+ <include>%regex[.*[Cat|Dog].*Test.*]</include>
+ </includes>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ [...]
+</project></pre></div><p>Note the syntax %regex[expr], where expr is the actual expression and the rest is just wrapping. Also note that regex matches are done over .class files and not .java files.</p></div></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container-fluid">
+ <div class="row span16">Copyright © 2004-2012
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.
+
+ </div>
+
+ </div>
+ </footer>
+ </body>
+</html>
Added: websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/junit.html
==============================================================================
--- websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/junit.html (added)
+++ websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/junit.html Tue Dec 4 11:35:30 2012
@@ -0,0 +1,332 @@
+<!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 Aug 25, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Using JUnit</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+ <style>body{padding-top: 20px;}</style>
+
+ <script type="text/javascript" src="../js/apache-maven-fluido.min.js"></script>
+
+
+
+ <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript" src="http://www.google-analytics.com/urchin.js"></script>
+
+
+ <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+
+ <meta name="author" content="Kristian Rosenvold krosenvold@apache.org" />
+ <meta name="Date-Creation-yyyymmdd" content="20101010" />
+ <meta name="Date-Revision-yyyymmdd" content="20120825" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body>
+
+
+ <div class="container-fluid">
+ <div id="banner">
+ <div class="pull-left"> <a href="../../../" id="bannerLeft">
+ <img src="../../../images/apache-maven-project.png" alt="Maven Surefire Plugin"/>
+ </a>
+ </div>
+ <div class="pull-right"> <div id="bannerRight">
+ <img src="../../../images/maventxt_logo_200.gif" alt="Maven Surefire Plugin"/>
+ </div>
+ </div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+
+
+ <li class="">
+ <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../../../index.html" title="Maven">Maven</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../../../surefire/" title="Surefire">Surefire</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../" title="Maven Surefire Plugin">Maven Surefire Plugin</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">Using JUnit</li>
+
+
+ <li id="publishDate" class="pull-right">Last Published: 2012-08-25</li> <li class="divider pull-right">|</li>
+ <li id="projectVersion" class="pull-right">Version: 2.12.3</li>
+ </ul>
+ </div>
+
+ <div id="leftColumn" class="sidebar">
+ <div class="well">
+
+
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="Introduction">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../plugin-info.html" title="Goals">Goals</a>
+ </li>
+ <li class="none">
+ <a href="../usage.html" title="Usage">Usage</a>
+ </li>
+ <li class="none">
+ <a href="../featurematrix.html" title="Feature matrix">Feature matrix</a>
+ </li>
+ <li class="none">
+ <a href="../api.html" title="API">API</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html" title="FAQ">FAQ</a>
+ </li>
+ </ul>
+ <h5>Examples</h5>
+ <ul>
+ <li class="none">
+ <a href="../examples/testng.html" title="Using TestNG">Using TestNG</a>
+ </li>
+ <li class="none">
+ <strong>Using JUnit</strong>
+ </li>
+ <li class="none">
+ <a href="../examples/skipping-test.html" title="Skipping Tests">Skipping Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/inclusion-exclusion.html" title="Inclusions and Exclusions of Tests">Inclusions and Exclusions of Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/single-test.html" title="Running a Single Test">Running a Single Test</a>
+ </li>
+ <li class="none">
+ <a href="../examples/class-loading.html" title="Class Loading Issues">Class Loading Issues</a>
+ </li>
+ <li class="none">
+ <a href="../examples/debugging.html" title="Debugging Tests">Debugging Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/system-properties.html" title="System Properties">System Properties</a>
+ </li>
+ <li class="none">
+ <a href="../examples/configuring-classpath.html" title="Configuring the Classpath">Configuring the Classpath</a>
+ </li>
+ <li class="none">
+ <a href="../examples/providers.html" title="Selecting providers">Selecting providers</a>
+ </li>
+ </ul>
+ <h5>Developer Center</h5>
+ <ul>
+ <li class="none">
+ <a href="../developing.html" title="Developing">Developing</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../../ant-tasks/index.html" title="Ant Tasks">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../../archetype/index.html" title="Archetype">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../../doxia/index.html" title="Doxia">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../../jxr/index.html" title="JXR">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../../maven-1.x/index.html" title="Maven 1.x">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../../../index.html" title="Maven 2 & 3">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../../../plugins/index.html" title="Plugins">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../../scm/index.html" title="SCM">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../../shared/index.html" title="Shared Components">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../../skins/index.html" title="Skins">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../../index.html" title="Surefire">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../../wagon/index.html" title="Wagon">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+ </li>
+ </ul>
+
+
+
+
+ <div id="poweredBy">
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+ </a>
+ </div>
+ </div>
+ </div>
+
+ <div id="bodyColumn" class="content">
+ <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/refer
ences/apt-format.html --><div class="section"><h2>Using JUnit<a name="Using_JUnit"></a></h2><div class="section"><h3>Configuring JUnit<a name="Configuring_JUnit"></a></h3><p>To get started with JUnit, you need to add the required version of JUnit to your project:</p><div class="source"><pre class="prettyprint"><dependencies>
+ [...]
+ <dependency>
+ <groupId>junit</groupId>
+ <artifactId>junit</artifactId>
+ <version>4.8.1</version>
+ <scope>test</scope>
+ </dependency>
+ [...]
+</dependencies></pre></div><p>This is the only step that is required to get started - you can now create tests in your test source directory (eg, <tt>src/test/java</tt>).</p></div><div class="section"><h3>Different Generations of JUnit support<a name="Different_Generations_of_JUnit_support"></a></h3><p>Surefire supports three different generations of JUnit: JUnit 3.8.x, JUnit 4.x (serial provider) and JUnit 4.7 (junit-core provider with parallel support). The provider is selected based on the JUnit version in your project and the configuration parameters (for parallel).</p></div><div class="section"><h3>Upgrade check for JUnit 4.x<a name="Upgrade_check_for_JUnit_4.x"></a></h3><p>As of Surefire version 2.7, the algorithm for choosing which tests to run has changed. From 2.7 and on, only valid JUnit tests are run for all versions of JUnit, where older versions of the plugin would also run invalid tests that satisfied the naming convention.</p><p>When upgrading from a Sur
efire version prior to 2.7, the build can be run with the flag -Dsurefire.junit4.upgradecheck. This will perform a check and notify you of any invalid tests that will not be run with this version of Surefire (and the build fails). This is only meant to be used as a tool when upgrading to check that all expected tests will be run. It is a transitional feature that will be removed in a future version of surefire.</p></div><div class="section"><h3>How is the provider chosen ?<a name="How_is_the_provider_chosen_"></a></h3><p>If nothing is configured, surefire detects which junit version to use by the following algorithm:</p><div class="source"><pre class="prettyprint">if the JUnit version in the project >= 4.7 and the parallel attribute has ANY value
+ use junit47 provider
+if JUnit >= 4.0 is present
+ use junit4 provider
+else
+ use junit3.8.1</pre></div><p>Please note that the "else" part of this algorithm is also a FAQ response:</p><p>You depend on the appropriate version of JUnit being present in the project dependencies, or surefire may choose the wrong provider. If, for instance, one of your dependencies pulls in JUnit 3.8.1 you risk that surefire chooses the 3.8.1 provider, which will not support annotations or any of the 4.x features.</p><p>Use mvn dependency:tree, pom dependency ordering and/or and exclusion of transitive dependencies to fix this problem.</p><div class="section"><h4>Manually specifying a provider<a name="Manually_specifying_a_provider"></a></h4><p>You can also manually force a specific provider by adding it as a dependency to Surefire itself:</p><div class="source"><pre class="prettyprint"><plugins>
+[...]
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.12.3</version>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.maven.surefire</groupId>
+ <artifactId>surefire-junit47</artifactId>
+ <version>2.12.3</version>
+ </dependency>
+ </dependencies>
+ </plugin>
+[...]
+</plugins></pre></div><p>When using this technique there is no check that the proper test-frameworks are present on your project's classpath. Failing to add the proper test-frameworks will result in a build failure.</p></div></div><div class="section"><h3>Running tests in parallel<a name="Running_tests_in_parallel"></a></h3><p>From JUnit 4.7 and onwards you can run your tests in parallel. To do this, you must set the <tt>parallel</tt> parameter, and may change the <tt>threadCount</tt> or <tt>useUnlimitedThreads</tt> attribute. For example:</p><div class="source"><pre class="prettyprint"><plugins>
+ [...]
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.12.3</version>
+ <configuration>
+ <parallel>methods</parallel>
+ <threadCount>10</threadCount>
+ </configuration>
+ </plugin>
+ [...]
+</plugins></pre></div><p>If your tests specify any value for the "parallel" attribute and your project uses JUnit 4.7+, your request will be routed to the concurrent JUnit provider, which uses the JUnit JUnitCore testrunner.</p><p>This is particularly useful for slow tests that can have high concurrency.</p><p>As of surefire 2.7, no additional dependencies are needed to use the full set of options with parallel.</p></div><div class="section"><h3>Using custom listeners and reporters<a name="Using_custom_listeners_and_reporters"></a></h3><p>JUnit4/4.7 provider provides support for attaching custom RunListeners to your tests.</p><p>You can configure multiple custom listeners like this:</p><div class="source"><pre class="prettyprint"><plugins>
+[...]
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.12.3</version>
+ <configuration>
+ <properties>
+ <property>
+ <name>listener</name>
+ <value>com.mycompany.MyResultListener,com.mycompany.MyResultListener2</value>
+ </property>
+ </configuration>
+ </plugin>
+[...]
+</plugins></pre></div></div><div class="section"><h3>Using a security manager (JUnit3 only)<a name="Using_a_security_manager_JUnit3_only"></a></h3><p>As long as forkMode!=never and you use JUnit3, you can run your tests with a java security manager active. The classname of the security manager must be sent as a system property variable to the JUnit3 provider.</p><p>JUnit4 uses mechanisms internally that are not compatible with the tested security managers and is not supported by surefire.</p><div class="source"><pre class="prettyprint"><plugins>
+[...]
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.12.3</version>
+ <configuration>
+ <systemPropertyVariables>
+ <surefire.security.manager>java.lang.SecurityManager</surefire.security.manager>
+ </systemPropertyVariables>
+ </configuration>
+ </plugin>
+[...]
+</plugins></pre></div></div><div class="section"><h3>Using a security manager (All providers)<a name="Using_a_security_manager_All_providers"></a></h3><p>Alternatively you can define a policy file that allows all providers to run with surefire and send them using the argLine parameter and two system properties;</p><div class="source"><pre class="prettyprint"><plugins>
+[...]
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.12.3</version>
+ <configuration>
+ <argLine>-Djava.security.manager -Djava.security.policy=${basedir}/src/test/resources/java.policy</argLine>
+ </configuration>
+ </plugin>
+[...]
+</plugins></pre></div><p>The disadvantage of this solution is that the policy changes will affect the tests too, which make the security environment less realistic.</p></div><div class="section"><h3>Using JUnit Categories<a name="Using_JUnit_Categories"></a></h3><p>JUnit 4.8 introduced the notion of Categories. You can use JUnit categories by using the <tt>groups</tt> parameter. As long as the JUnit version in the project is 4.8 or higher, the presence of the "groups" parameter will automatically make surefire select the junit47 provider, which supports groups.</p><div class="source"><pre class="prettyprint"><plugins>
+[...]
+ <plugin>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.11</version>
+ <configuration>
+ <groups>com.mycompany.SlowTests</groups>
+ </configuration>
+ </plugin>
+[...]
+</plugins></pre></div><p>This will execute only those tests annotated with the <tt>@Category(com.mycompany.SlowTests.class)</tt> annotation and those tests annotated with <tt>@Category(com.mycompany.SlowerTests.class)</tt> if class/interface <tt>SlowerTests</tt> is subclass of <tt>SlowTests</tt>:</p><div class="source"><pre class="prettyprint"> public interface SlowTests{}
+ public interface SlowerTests extends SlowTests{}</pre></div><div class="source"><pre class="prettyprint"> public class AppTest {
+ @Test
+ @Category(com.mycompany.SlowTests.class)
+ public void testSlow() {
+ System.out.println("slow");
+ }
+
+ @Test
+ @Category(com.mycompany.SlowerTests.class)
+ public void testSlower() {
+ System.out.println("slower");
+ }
+
+ @Test
+ @Category(com.cmycompany.FastTests.class)
+ public void testSlow() {
+ System.out.println("fast");
+ }
+ }</pre></div><p>The @Category annotation can also be applied at class-level.</p><p>For more information on JUnit, see the <a class="externalLink" href="http://www.junit.org">JUnit web site</a>.</p></div></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container-fluid">
+ <div class="row span16">Copyright © 2004-2012
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.
+
+ </div>
+
+ </div>
+ </footer>
+ </body>
+</html>
Added: websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/pojo-test.html
==============================================================================
--- websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/pojo-test.html (added)
+++ websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/pojo-test.html Tue Dec 4 11:35:30 2012
@@ -0,0 +1,223 @@
+<!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 Aug 25, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Using POJO tests</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+ <style>body{padding-top: 20px;}</style>
+
+ <script type="text/javascript" src="../js/apache-maven-fluido.min.js"></script>
+
+
+
+ <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript" src="http://www.google-analytics.com/urchin.js"></script>
+
+
+ <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+
+ <meta name="author" content="Christian Gruber" />
+ <meta name="Date-Revision-yyyymmdd" content="20120825" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body>
+
+
+ <div class="container-fluid">
+ <div id="banner">
+ <div class="pull-left"> <a href="../../../" id="bannerLeft">
+ <img src="../../../images/apache-maven-project.png" alt="Maven Surefire Plugin"/>
+ </a>
+ </div>
+ <div class="pull-right"> <div id="bannerRight">
+ <img src="../../../images/maventxt_logo_200.gif" alt="Maven Surefire Plugin"/>
+ </div>
+ </div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+
+
+ <li class="">
+ <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../../../index.html" title="Maven">Maven</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../../../surefire/" title="Surefire">Surefire</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../" title="Maven Surefire Plugin">Maven Surefire Plugin</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">Using POJO tests</li>
+
+
+ <li id="publishDate" class="pull-right">Last Published: 2012-08-25</li> <li class="divider pull-right">|</li>
+ <li id="projectVersion" class="pull-right">Version: 2.12.3</li>
+ </ul>
+ </div>
+
+ <div id="leftColumn" class="sidebar">
+ <div class="well">
+
+
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="Introduction">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../plugin-info.html" title="Goals">Goals</a>
+ </li>
+ <li class="none">
+ <a href="../usage.html" title="Usage">Usage</a>
+ </li>
+ <li class="none">
+ <a href="../featurematrix.html" title="Feature matrix">Feature matrix</a>
+ </li>
+ <li class="none">
+ <a href="../api.html" title="API">API</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html" title="FAQ">FAQ</a>
+ </li>
+ </ul>
+ <h5>Examples</h5>
+ <ul>
+ <li class="none">
+ <a href="../examples/testng.html" title="Using TestNG">Using TestNG</a>
+ </li>
+ <li class="none">
+ <a href="../examples/junit.html" title="Using JUnit">Using JUnit</a>
+ </li>
+ <li class="none">
+ <a href="../examples/skipping-test.html" title="Skipping Tests">Skipping Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/inclusion-exclusion.html" title="Inclusions and Exclusions of Tests">Inclusions and Exclusions of Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/single-test.html" title="Running a Single Test">Running a Single Test</a>
+ </li>
+ <li class="none">
+ <a href="../examples/class-loading.html" title="Class Loading Issues">Class Loading Issues</a>
+ </li>
+ <li class="none">
+ <a href="../examples/debugging.html" title="Debugging Tests">Debugging Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/system-properties.html" title="System Properties">System Properties</a>
+ </li>
+ <li class="none">
+ <a href="../examples/configuring-classpath.html" title="Configuring the Classpath">Configuring the Classpath</a>
+ </li>
+ <li class="none">
+ <a href="../examples/providers.html" title="Selecting providers">Selecting providers</a>
+ </li>
+ </ul>
+ <h5>Developer Center</h5>
+ <ul>
+ <li class="none">
+ <a href="../developing.html" title="Developing">Developing</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../../ant-tasks/index.html" title="Ant Tasks">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../../archetype/index.html" title="Archetype">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../../doxia/index.html" title="Doxia">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../../jxr/index.html" title="JXR">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../../maven-1.x/index.html" title="Maven 1.x">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../../../index.html" title="Maven 2 & 3">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../../../plugins/index.html" title="Plugins">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../../scm/index.html" title="SCM">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../../shared/index.html" title="Shared Components">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../../skins/index.html" title="Skins">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../../index.html" title="Surefire">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../../wagon/index.html" title="Wagon">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+ </li>
+ </ul>
+
+
+
+
+ <div id="poweredBy">
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+ </a>
+ </div>
+ </div>
+ </div>
+
+ <div id="bodyColumn" class="content">
+ <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/refer
ences/apt-format.html --><div class="section"><h2>Defining a POJO Test<a name="Defining_a_POJO_Test"></a></h2><p>POJO tests look very much like JUnit or TestNG tests, though they do not require dependencies on these artifacts. A test class should be named <tt>**/*Test</tt> and should contain <tt>test*</tt> methods which will each be executed by surefire. </p><p>Validating assertions can be done using the JDK 1.4 <tt>assert</tt> keyword. Simultaneous test execution is not possible with POJO tests.</p><p>Fixture can be setup before and after each <tt>test*</tt> method by implementing a set-up and a tear-down method. These methods must match these signatures to be recognized and executed before and after each test method.</p><div class="source"><pre class="prettyprint">public void setUp();
+public void tearDown();</pre></div><p>These fixture methods can also throw any exception and will still be valid.</p></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container-fluid">
+ <div class="row span16">Copyright © 2004-2012
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.
+
+ </div>
+
+ </div>
+ </footer>
+ </body>
+</html>
Added: websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/providers.html
==============================================================================
--- websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/providers.html (added)
+++ websites/production/maventest/content/plugins/maven-surefire-plugin-2.12.3/examples/providers.html Tue Dec 4 11:35:30 2012
@@ -0,0 +1,238 @@
+<!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 Aug 25, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Selecting providers</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+ <style>body{padding-top: 20px;}</style>
+
+ <script type="text/javascript" src="../js/apache-maven-fluido.min.js"></script>
+
+
+
+ <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript" src="http://www.google-analytics.com/urchin.js"></script>
+
+
+ <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+
+ <meta name="author" content="Kristian Rosenvold krosenvold@apache.org" />
+ <meta name="Date-Creation-yyyymmdd" content="20101204" />
+ <meta name="Date-Revision-yyyymmdd" content="20120825" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body>
+
+
+ <div class="container-fluid">
+ <div id="banner">
+ <div class="pull-left"> <a href="../../../" id="bannerLeft">
+ <img src="../../../images/apache-maven-project.png" alt="Maven Surefire Plugin"/>
+ </a>
+ </div>
+ <div class="pull-right"> <div id="bannerRight">
+ <img src="../../../images/maventxt_logo_200.gif" alt="Maven Surefire Plugin"/>
+ </div>
+ </div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+
+
+ <li class="">
+ <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../../../index.html" title="Maven">Maven</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../../../surefire/" title="Surefire">Surefire</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">
+ <a href="../" title="Maven Surefire Plugin">Maven Surefire Plugin</a>
+ <li class="divider ">/</li>
+ </li>
+ <li class="">Selecting providers</li>
+
+
+ <li id="publishDate" class="pull-right">Last Published: 2012-08-25</li> <li class="divider pull-right">|</li>
+ <li id="projectVersion" class="pull-right">Version: 2.12.3</li>
+ </ul>
+ </div>
+
+ <div id="leftColumn" class="sidebar">
+ <div class="well">
+
+
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="Introduction">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../plugin-info.html" title="Goals">Goals</a>
+ </li>
+ <li class="none">
+ <a href="../usage.html" title="Usage">Usage</a>
+ </li>
+ <li class="none">
+ <a href="../featurematrix.html" title="Feature matrix">Feature matrix</a>
+ </li>
+ <li class="none">
+ <a href="../api.html" title="API">API</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html" title="FAQ">FAQ</a>
+ </li>
+ </ul>
+ <h5>Examples</h5>
+ <ul>
+ <li class="none">
+ <a href="../examples/testng.html" title="Using TestNG">Using TestNG</a>
+ </li>
+ <li class="none">
+ <a href="../examples/junit.html" title="Using JUnit">Using JUnit</a>
+ </li>
+ <li class="none">
+ <a href="../examples/skipping-test.html" title="Skipping Tests">Skipping Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/inclusion-exclusion.html" title="Inclusions and Exclusions of Tests">Inclusions and Exclusions of Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/single-test.html" title="Running a Single Test">Running a Single Test</a>
+ </li>
+ <li class="none">
+ <a href="../examples/class-loading.html" title="Class Loading Issues">Class Loading Issues</a>
+ </li>
+ <li class="none">
+ <a href="../examples/debugging.html" title="Debugging Tests">Debugging Tests</a>
+ </li>
+ <li class="none">
+ <a href="../examples/system-properties.html" title="System Properties">System Properties</a>
+ </li>
+ <li class="none">
+ <a href="../examples/configuring-classpath.html" title="Configuring the Classpath">Configuring the Classpath</a>
+ </li>
+ <li class="none">
+ <strong>Selecting providers</strong>
+ </li>
+ </ul>
+ <h5>Developer Center</h5>
+ <ul>
+ <li class="none">
+ <a href="../developing.html" title="Developing">Developing</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../../ant-tasks/index.html" title="Ant Tasks">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../../archetype/index.html" title="Archetype">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../../doxia/index.html" title="Doxia">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../../jxr/index.html" title="JXR">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../../maven-1.x/index.html" title="Maven 1.x">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../../../index.html" title="Maven 2 & 3">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../../../plugins/index.html" title="Plugins">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../../scm/index.html" title="SCM">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../../shared/index.html" title="Shared Components">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../../skins/index.html" title="Skins">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../../index.html" title="Surefire">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../../wagon/index.html" title="Wagon">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+ </li>
+ </ul>
+
+
+
+
+ <div id="poweredBy">
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+ </a>
+ </div>
+ </div>
+ </div>
+
+ <div id="bodyColumn" class="content">
+ <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/refer
ences/apt-format.html --><div class="section"><h2>Selecting providers<a name="Selecting_providers"></a></h2><div class="section"><h3>Selecting a provider<a name="Selecting_a_provider"></a></h3><p>Surefire normally automatically selects which test-framework provider to use based on the version of TestNG/JUnit present in your project's classpath. In some cases it may be desirable to manually override such a selection. This can be done by adding the required provider as a dependency to the surefire-plugin.</p><p>The following example shows how to force the junit 4.7 provider:</p><div class="source"><pre class="prettyprint"><plugins>
+ [...]
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.12.3</version>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.maven.surefire</groupId>
+ <artifactId>surefire-junit47</artifactId>
+ <version>2.12.3</version>
+ </dependency>
+ </dependencies>
+ </plugin>
+ [...]
+</plugins></pre></div><p>The providers supplied with surefire are surefire-junit3, surefire-junit4, surefire-junit47 and surefire-testng. Please note that forcing a provider still requires that the test framework is properly set up on your project classpath.</p><p>You can also specify multiple providers as dependencies, and they will all be run and produce a common report. This may be especially handy with external providers, since there are few use-cases for combining the included providers.</p></div></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container-fluid">
+ <div class="row span16">Copyright © 2004-2012
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.
+
+ </div>
+
+ </div>
+ </footer>
+ </body>
+</html>