Skip to Content
Last modified by Markus Ruggiero on 2017/02/20 21:13
Hide last authors
bogo 37.1 1 [[JRebel>>url:http://jrebel.com||shape="rect"]] is a tool from [[ZeroTurnaround>>url:http://www.zeroturnaround.com||shape="rect"]] that makes it possible for Java developers to instantly see any code change made to an app //without// redeploying. JRebel lets you see code changes instantly, versioning classes and resources individually and updating one at a time instead of as a lump application redeploy.
bogo 13.1 2
Markus Ruggiero 40.1 3 === Also take a look at: [[Using DCEVM and Hotswap for rapid turnaround>>doc:WOL.Home.WOLips.Using DCEVM and Hotswap for rapid turnaround.WebHome||shape="rect"]] ===
Theodore Petrosky 39.1 4
Kieran Kelleher 31.1 5 === How to install and use JRebel ===
bogo 13.1 6
bogo 37.1 7 * Get a free 30-day license, a[[open source developer license>>url:http://sales.zeroturnaround.com||shape="rect"]] (Get JRebel for free section) or a paid license from [[ZeroTurnaround>>url:http://www.zeroturnaround.com||shape="rect"]]
8 * Put the license file (jrebel.lic) into a directory named .jrebel in your home directory. ( ~~/.jrebel/jrebel.lic )
9 * Get the JRebel plugin. Go to Eclipse->Preferences->Available Software Sites, add [[http:~~/~~/www.zeroturnaround.com/update-site/>>url:http://www.zeroturnaround.com/update-site/||shape="rect"]]
bogo 13.1 10
bogo 37.1 11 [[image:attach:AddZeroTurnAround.png]]
Kieran Kelleher 31.1 12
13 * Download the Jrebel Eclipse Integration and perhaps the JRebel Eclipse Debugger Integration from install new Software
14
bogo 37.1 15 [[image:attach:InstallSoftware.png]]
Kieran Kelleher 31.1 16
17 * Make sure you have checked the JRebel Plugin in WOLips if you download the newest version.
18
bogo 37.1 19 [[image:attach:UpdateWOLipsWithJRebel.png]]
Kieran Kelleher 31.1 20
bogo 35.1 21 * Restart Eclipse. You will now have a Jrebel preference item in your eclipse preferences and JRebel is ready for use with your projects.
Kieran Kelleher 31.1 22
bogo 13.1 23 You have now installed and setup the stuff that WOLips needs to know about the location of JRebel.jar.
24
Kieran Kelleher 31.1 25 == How do you use it? ==
bogo 13.1 26
27 Well that has become very simple since the inclusion of Quinton Dolan's JRebel plugin in WOLips.
28
bogo 35.1 29 For a project in which want to use jrebel to change java code while running, go to the run configuration of the project, under the contextual menu Run As->Run Configurations.
bogo 13.1 30
31 In the Run Configuration of a WOApplication you will notice an extra Tab, called JRebel.
32
bogo 35.1 33 Select the tab, and check the check boxes to enable JRebel Agent and (eventually) Enable debug logging.
bogo 13.1 34
bogo 37.1 35 [[image:attach:EnableJRebel.png]]
bogo 13.1 36
bogo 35.1 37 Start you project from the Run Configuration.
bogo 13.1 38
bogo 35.1 39 Suddenly, you will get messages about jrebel being loaded, and some extra information about what settings are available as extra arguments.
Kieran Kelleher 15.1 40
bogo 35.1 41 {{info}}
42 If you get out of memory error with respect to "Perm Gen space", just allocate more Perm Gen memory in command line launch args in your launch configuration. For example:
43
bogo 37.1 44 -XX:MaxPermSize=384m
bogo 35.1 45 {{/info}}
46
47 Start changing your java code on the fly: watch and start saving time.
48
Theodore Petrosky 39.1 49 [[image:attach:JRebelWOlipsLog.png]]
Kieran Kelleher 31.1 50
bogo 37.1 51 * Profit! (for the europeans: Extra Time Off!)
bogo 35.1 52
53 == More information ==
54
bogo 37.1 55 [[Old screencast from David Avendasora about using JRebel with Eclipse 3.4>>url:http://www.wocommunity.org/podcasts/WOJavaRebel_Setup.mov||shape="rect"]].