Version 11.1 by Samuel Pelletier on 2015/07/07 17:42

Hide last authors
Samuel Pelletier 8.1 1 DCEVM and Hotswap enable rapid turnaround by allowing almost any class change to the running VM. It offers an experience very similar to JRebel for WebObjects developers. With this tool, you usually do not have to restart your application after code change.
Samuel Pelletier 4.1 2
3 = Prerequisites =
4
Samuel Pelletier 8.1 5 * A JRE patched with the DCEVM
Samuel Pelletier 4.1 6 * (% style="line-height: 1.4285715;" %)The Hotwsap agent to handle the WebObjects caches.
7
8 === (% style="line-height: 1.4285715;" %)Patching the VM(%%) ===
9
Samuel Pelletier 10.1 10 (% style="line-height: 1.4285715;" %)DCEVM is the patch that enable the enhanced class redefinition in the VM. Download the installer for your JRE version and install the alternative VM. The patch is not always available for the latest update of the JRE, you may try the latest update available but it may not works. At the time I write this, the patch for Java 1.8 update 45 is at build 15 and it does not works completely, I get exception because some DelegatingClassLoader are not updated. The version for Java 1.7 update 71 build 2 works fine with java 1.7.0_79.
Samuel Pelletier 4.1 11
Samuel Pelletier 10.1 12 DCEVM download site: **[[http:~~/~~/dcevm.github.io>>url:http://dcevm.github.io||shape="rect"]] **
Samuel Pelletier 4.1 13
Samuel Pelletier 8.1 14 === (% style="line-height: 1.4285715;" %)Downloading the Hotswap agent(%%) ===
Samuel Pelletier 4.1 15
Samuel Pelletier 8.1 16 (% style="line-height: 1.4285715;" %)Hotwsap agent allows plugins to react to class redefinition events. These plugins are similar to the the JRebel plugins and add frameworks specific code to make sure they handle correctly to the class changes.
Samuel Pelletier 4.1 17
Samuel Pelletier 8.1 18 (% style="line-height: 1.4285715;" %)Download the hot swap agent jar from my fork at [[https:~~/~~/github.com/spelletier/HotswapAgent/releases/tag/0.2_with_WO>>url:https://github.com/spelletier/HotswapAgent/releases/tag/0.2_with_WO||shape="rect"]] to an easy to type location, you will need the location to enable it.
Samuel Pelletier 4.1 19
Samuel Pelletier 8.1 20 === How to use in a project ===
Samuel Pelletier 4.1 21
Samuel Pelletier 10.1 22 To enable HotSwap, add the following to the Run configuration of your project in the VM argument section:
Samuel Pelletier 4.1 23
Samuel Pelletier 8.1 24 -XXaltjvm=dcevm -javaagent:/replace_with_correct_path/hotswap-agent.jar
Samuel Pelletier 4.1 25
Samuel Pelletier 8.1 26 === Known limitations ===
Samuel Pelletier 4.1 27
Samuel Pelletier 8.1 28 * Change of superclass is not supported by DCEVM.
Samuel Pelletier 10.1 29 * Modifying the return type of a method breaks. It seems there is some cache not cleared.
Samuel Pelletier 8.1 30
Samuel Pelletier 10.1 31 (% style="line-height: 1.4285715;" %)
32
33
Samuel Pelletier 4.1 34 (% style="line-height: 1.4285715;" %)