I Use This!
Activity Not Available
Analyzed almost 2 years ago. based on code collected almost 2 years ago.

Project Summary

Hotswap Task for Ant 1.6.x
This jar file contains a hotswap target for Ant that allows your build file to replace class definitions on a running JVM.

This jar file should be put in the ant/lib directory. hotswap.jar It was compiled against the Ant 1.6.1 codebase.

This has been tested with j2sdk1.4.1_06, but should work with any 1.4 and greater JVM. It uses the JDI (Java Debug Interface) API.

The Hotswap target
Replaces classes on a running JVM. This task can take the following

verbose - prints class names as they are being swapped
failonerror - causes task to exit if any error occurs
host - the host of the JVM to be attached to (defaults to localhost)
port - the port number to be used to attach to the JVM
name - if not using a socket connection, this name is the share memory label

Of these arguments, the host and port are required. Or,
the name can be used instead to indicate a shared mem connection.

See the JPDA documentation for details on the JVM runtime options.


These are the options that work with the example below: -Xdebug -Xrunjdwp:transport=dt_socket,address=9000,server=y,suspend=n

Add this line to your build.xml

<taskdef name="hotswap" classname="dak.ant.taskdefs.Hotswap"/>

This is an example of how to hotswap with a JVM on port 9000 on your local machine

<target name="hotswap">
<format property="class.tstamp" pattern="MM/dd/yyyy kk:mm:ss" />

<javac destdir="${build.classes.dir}>
<fileset dir="${dev.src.dir}" includes="**/*.java"/>

<hotswap verbose="true" port="9000">
<fileset dir="${build.classes.dir}" includes="**/*.class">
<date datetime="${class.tstamp}" pattern="MM/dd/yyyy kk:mm:ss" when="after" granularity="0"/>

This example illustrates creating a timestamp with granularity of seconds. Then, compiling the java files that have changed. Finally, the target uses the timestamp, formatted with seconds, to pick files that have changed since that timestamp and pass them to the target.
To get this functionality in the date selector, you'll need one of these;

The ant 1.6.2 beta. OR
The ant 1.6.1 release, plus this jar in the lib directory. (it contains the patch for the date selector).

For Vim users, I recommend using ant.vim to allow you to call a hotswap task from Vim. It (along with this task) lets you edit code, then with a few keystrokes, hotswap the new code into your running app! Very Cool!

I can be reached via e-mail and I lurk on the Ant developers list.


ant java

In a Nutshell, Hotswap with Ant...

Quick Reference

GNU Library or "Lesser" GPL (LGPL)

Place Warranty

Use Patent Claims

Commercial Use





Hold Liable


Distribute Original

Disclose Source

Include Copyright

State Changes

Include License

Include Install Instructions

These details are provided for information only. No information here is legal advice and should not be used as such.

All Licenses

This Project has No vulnerabilities Reported Against it

Did You Know...

  • ...
    Black Duck offers a free trial so you can discover if there are open source vulnerabilities in your code
  • ...
    anyone with an Open Hub account can update a project's tags
  • ...
    use of OSS increased in 65% of companies in 2016
  • ...
    check out hot projects on the Open Hub

30 Day Summary

Jun 24 2016 — Jul 24 2016

12 Month Summary

Jul 24 2015 — Jul 24 2016


Be the first to rate this project
Click to add your rating
Review this Project!