Using JRebel (previously called JavaRebel) with WOLips

JRebel is a tool from [[ZeroTurnaround>>http://www.zeroturnaround.com]].

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

5

=== How to install and use JRebel ===

6

7

* Get a free 30-day license, a open source developer license or a paid license from [[ZeroTurnaround>>http://www.zeroturnaround.com]]

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/]]

10

11

[[image:AddZeroTurnAround.png]]

12

13

* Download the Jrebel Eclipse Integration and perhaps the JRebel Eclipse Debugger Integration from install new Software

14

15

[[image:InstallSoftware.png]]

16

17

* Make sure you have checked the JRebel Plugin in WOLips if you download the newest version.

18

19

[[image:UpdateWOLipsWithJRebel.png]]

20

21

* Restart Eclipse. You will now have a Jrebel preference item in your eclipse preferences and JRebel is ready for use with your projects.

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

35

[[image:EnableJRebel.png]]

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.

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

45

\-XX:MaxPermSize=384m

Start changing your java code on the fly: watch and start saving time.

50

51

[[image:JRebelWOLipsLog.png]]

52