114 lines
4.6 KiB
HTML
114 lines
4.6 KiB
HTML
<html>
|
|
<head>
|
|
<title>TestNG - Migrating from JUnit</title>
|
|
|
|
<link rel="stylesheet" href="testng.css" type="text/css" />
|
|
<link type="text/css" rel="stylesheet" href="http://beust.com/beust.css" />
|
|
<script type="text/javascript" src="http://beust.com/prettify.js"></script>
|
|
<script type="text/javascript" src="banner.js"></script>
|
|
|
|
<script type="text/javascript" src="http://beust.com/scripts/shCore.js"></script>
|
|
<script type="text/javascript" src="http://beust.com/scripts/shBrushJava.js"></script>
|
|
<script type="text/javascript" src="http://beust.com/scripts/shBrushXml.js"></script>
|
|
<script type="text/javascript" src="http://beust.com/scripts/shBrushBash.js"></script>
|
|
<script type="text/javascript" src="http://beust.com/scripts/shBrushPlain.js"></script>
|
|
<link type="text/css" rel="stylesheet" href="http://beust.com/styles/shCore.css"/>
|
|
<link type="text/css" rel="stylesheet" href="http://beust.com/styles/shThemeCedric.css"/>
|
|
<script type="text/javascript">
|
|
SyntaxHighlighter.config.clipboardSwf = 'scripts/clipboard.swf';
|
|
SyntaxHighlighter.defaults['gutter'] = false;
|
|
SyntaxHighlighter.all();
|
|
</script>
|
|
|
|
</head>
|
|
<body onLoad="prettyPrint()">
|
|
|
|
<script type="text/javascript">
|
|
displayMenu("migrating.html")
|
|
</script>
|
|
|
|
|
|
<h2 align="center">Migrating from JUnit</h2>
|
|
|
|
<h3>Using Eclipse</h3>
|
|
|
|
The easiest way to convert your JUnit tests to TestNG is to use the Eclipse TestNG plug-in refactoring support. You will find a full description of its features in the <a href="eclipse.html#eclipse-quickfix">Eclipse section</a>.
|
|
|
|
<h3>Asserts</h3>
|
|
Note that the class <tt>org.testng.Assert</tt> uses a different argument ordering than the ones used by JUnit. If you are porting code that uses JUnit's asserts, you might want to us a static import of that class:
|
|
|
|
<pre class="brush: java">
|
|
import static org.testng.AssertJUnit.*;
|
|
</pre>
|
|
|
|
<h3>Running JUnit Tests</h3>
|
|
|
|
<p>TestNG can automatically recognize and run JUnit tests, so you can use TestNG as a runner for all your existing tests and write new tests using TestNG.</p>
|
|
|
|
<p>All you have to do is to put JUnit library on the TestNG classpath, so it can find and use JUnit classes,
|
|
change your test runner from JUnit to TestNG in Ant and then run TestNG in <tt>"mixed"</tt> mode.
|
|
This way you can have all your tests in the same project, even in the same package, and start using TestNG.
|
|
This approach also allows you to convert your existing JUnit tests to TestNG incrementally.</p>
|
|
|
|
<h4>Example - replacing JUnit Ant task with TestNG one</h4>
|
|
|
|
JUnit version:
|
|
<pre class="brush: xml">
|
|
<junit dir="${work.dir}" errorproperty="tests.failed" failureproperty="tests.failed" fork="true">
|
|
<batchtest todir="${build.test.results.dir}">
|
|
<fileset dir="${test.src.dir}">
|
|
<include name="**/*Test.*"/>
|
|
</batchtest>
|
|
<classpath>
|
|
<path path="${run.test.classpath}"/>
|
|
</classpath>
|
|
<syspropertyset>
|
|
<propertyref prefix="test-sys-prop."/>
|
|
<mapper from="test-sys-prop.*" to="*" type="glob"/>
|
|
</syspropertyset>
|
|
<formatter type="xml"/>
|
|
<jvmarg value="-ea"/>
|
|
<jvmarg line="${run.jvmargs}"/>
|
|
</junit>
|
|
</pre>
|
|
|
|
TestNG version:
|
|
<pre class="brush: xml">
|
|
<taskdef name="testng" classname="org.testng.TestNGAntTask" classpath="${run.test.classpath}"/>
|
|
|
|
<fileset id="mixed.tests" dir="${test.src.dir}">
|
|
<include name="**/*Test.*"/>
|
|
</fileset>
|
|
|
|
<testng mode="mixed" classfilesetref="mixed.tests" workingDir="${work.dir}" failureProperty="tests.failed" outputdir="${build.test.results.dir}">
|
|
<classpath>
|
|
<pathelement path="${build.test.classes.dir}"/>
|
|
<pathelement path="${run.test.classpath}"/>
|
|
<pathelement path="${junit.lib}"/>
|
|
</classpath>
|
|
<propertyset>
|
|
<propertyref prefix="test-sys-prop."/>
|
|
<mapper from="test-sys-prop.*" to="*" type="glob"/>
|
|
</propertyset>
|
|
<jvmarg line="${run.jvmargs}"/>
|
|
</testng>
|
|
</pre>
|
|
|
|
|
|
<h3>Related reading</h3>
|
|
|
|
<ul>
|
|
<li><a href="http://www.opengamma.com/blog/2011/04/04/converting-opengamma-junit-testng">Here is the detailed report of a company that successfully converted a large codebase of JUnit 4 tests over to TestNG</a>.</li>
|
|
<li><a href="http://wiki.netbeans.org/TestNG_MixedMode">Mixed mode in TestNG</a>.</li>
|
|
</ul>
|
|
|
|
<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
|
|
</script>
|
|
<script type="text/javascript">
|
|
_uacct = "UA-238215-2";
|
|
urchinTracker();
|
|
</script>
|
|
|
|
|
|
</body>
|
|
|