Version 24.1 by Kieran Kelleher on 2011/07/25 20:09

Hide last authors
Kieran Kelleher 23.1 1 JRebel is a tool from [[ZeroTurnaround>>http://www.zeroturnaround.com]].
bogo 13.1 2
Denis Frolov 17.1 3 It is a java library that makes it possible to change java code while running a project in WOLips and see the results without having to restart. It is a great timesaver.
4
bogo 13.1 5 === How to install and use JRebel ===
6
Kieran Kelleher 19.1 7 * Get a free 30-day license, a open source developer license or a paid license from [[ZeroTurnaround>>http://www.zeroturnaround.com]]
Kieran Kelleher 21.1 8 * Put the license file (jrebel.lic) into a directory named .jrebel in your home directory. ( /.jrebel/jrebel.lic )
Kieran Kelleher 19.1 9 * Get the JRebel plugin. Go to Eclipse->Preferences->Available Software Sites, add [[http://www.zeroturnaround.com/update-site/]]
bogo 13.1 10
Kieran Kelleher 15.1 11 [[image:AddZeroTurnAround.png]]
bogo 13.1 12
13 * Download the Jrebel Eclipse Integration and perhaps the JRebel Eclipse Debugger Integration from install new Software
14
Kieran Kelleher 15.1 15 [[image:InstallSoftware.png]]
bogo 13.1 16
17 * Make sure you have checked the JRebel Plugin in WOLips if you download the newest version.
18
Kieran Kelleher 15.1 19 [[image:UpdateWOLipsWithJRebel.png]]
bogo 13.1 20
Kieran Kelleher 21.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.
bogo 13.1 22
23 You have now installed and setup the stuff that WOLips needs to know about the location of JRebel.jar.
24
25 == How do you use it? ==
26
27 Well that has become very simple since the inclusion of Quinton Dolan's JRebel plugin in WOLips.
28
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.
30
31 In the Run Configuration of a WOApplication you will notice an extra Tab, called JRebel.
32
33 Select the tab, and check the check boxes to enable JRebel Agent and (eventually) Enable debug logging.
34
Kieran Kelleher 15.1 35 [[image:EnableJRebel.png]]
bogo 13.1 36
37 Start you project from the Run Configuration.
38
39 Suddenly, you will get messages about jrebel being loaded, and some extra information about what settings are available as extra arguments.
40
41 {{info}}
Kieran Kelleher 15.1 42
bogo 13.1 43 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:
44
Kieran Kelleher 15.1 45 \-XX:MaxPermSize=384m
46
bogo 13.1 47 {{/info}}
48
49 Start changing your java code on the fly: watch and start saving time.
50
Kieran Kelleher 15.1 51 [[image:JRebelWOLipsLog.png]]
bogo 13.1 52
Kieran Kelleher 15.1 53 * Profit (for the europeans: Extra Time Off)
Kieran Kelleher 23.1 54
55 == More information ==
56
57 [[Old screencast from David Avendasora about using JRebel with Eclipse 3.4>>http://www.wocommunity.org/podcasts/WOJavaRebel_Setup.mov]].