Thorntail Runner
Thorntail Runner
Since 2.2.1.Final, there is a new way of running Thorntail apps in the IDE.
Previously, the only way was running the main
method of the Swarm
class. It caused problems with classpath.
Flat classpath that was used in this case didn’t mimic the JBoss Modules classpath that is used in the java -jar …
execution well enough.
Thorntail Runner uses JBoss Modules approach. It was tested with all the issues users reported in the old way of running apps in the IDE and it solved all of them.
Please note that it works only with war
packaging.
How to use Runner
Make it visible for your IDE
In order to use Thorntail Runner, you have add io.thorntail:thorntail-runner
to your application.
If you use Maven, you can simply make your project depend on it.
Just add the following to your dependencies.
Don’t worry, neither the thorntail-runner
itself nor its dependencies will leak to the uberjar that Thorntail Maven plugin generates for your project.
<dependency>
<groupId>io.thorntail</groupId>
<artifactId>thorntail-runner</artifactId>
<version>${version.thorntail}</version>
</dependency>
Run it
If you use IntelliJ IDEA, use Ctrl/Cmd+N to find the Runner
class. In Eclipse you can use Ctrl/Cmd+Shift+T.
When you find it, it’s just a matter of running its main
method.
You can customize Runner’s behavior by using specific system properties. They are listed in the javadoc of the class (or here)
Call for feedback
It would be great to get your feedback on the Thorntail Runner, preferably through our Google group.