Usage with maven-surefire-plugin

You have to configure the surefire plugin to use the additional TestLinkXmlRunListener. As can be seen below, the tester name and file-location for the result file may be provided as system properties. The resulting XML is written as UTF-8.

 <properties>
   <tljunit.version>X.X<tljunit.version>
 </properties>
 [...]
   <plugin>
     <groupId>org.apache.maven.plugins</groupId>
     <artifactId>maven-surefire-plugin</artifactId>
     <version>2.10</version>
     <dependencies>
       <dependency>
         <groupId>net.oneandone.testlinkjunit</groupId>
         <artifactId>tljunit-surefire</artifactId>
         <version>${tljunit.version}</version>
       </dependency>
     </dependencies>
     <configuration>
       <properties>
         <property>
           <name>listener</name>
           <value>net.oneandone.testlinkjunit.tljunit.TestLinkXmlRunListener</value>
         </property>
       </properties>
         <systemPropertyVariables>
           <testlink.results>target/my-testlink.xml</testlink.results>
           <testlink.tester>memyselfandi</testlink.tester>
         </systemPropertyVariables>
     </configuration>
   </plugin>
 [...]
   <dependencies>
       <dependency>
         <groupId>net.oneandone.testlinkjunit</groupId>
         <artifactId>tljunit</artifactId>
         <version>${tljunit.version}</version>
       </dependency>
   </dependencies>
 [...]
 
 

Now running mvn test will run your tests and put the resulting TestLink XML file into target/my-testlink.xml using memyselfandi as name of the user who executed the test run.

Using from main

 public static void main(String[] args) throws FileNotFoundException {
     final JUnitCore core = new JUnitCore();
     core.addListener(new TestLinkXmlRunListener(System.out, "name_of_tester"));
     core.run(MyTest.class);
 }
 

Note that this implementation is threadsafe but holds all results in memory before flushing them to the specified XML file.