Configuration
Configuration Manual
These options are available only in the JavaRebel 1.2 branch.
JavaRebel can be configured using Java system properties or the SDK API. To find out more about the configuration API please visit the SDK home and the API Javadoc. A description of available system properties follows.
- -Drebel.dirs=DIR1,DIR2,…
- This should be set to a comma-separated list of directories. Those directories should have the same layout as if they were in the classpath. The classes in those directories will be monitored for class changes. This is mainly meant to use with unexploded development by setting this property to the IDE class output directories.
For example-Drebel.dirs=c:/workspace/myproject/bin;c:/workspace/mylibrary/bin. - -Drebel.packages=PACKAGE1,PACKAGE2,…
- This should be set to a comma-separated list of Java packages. JavaRebel will then only reload classes in those packages and their subpackages. This is mainly used to restrict reloading to only a limited subset of classes, e.g. to improve performance.
For example-Drebel.packages=com.mycompany.mypackage,com.thirdparty.theirpackage. - -Drebel.packages_exclude=PACKAGE1,PACKAGE2,…
- This should be set to a comma-separated list of Java packages. JavaRebel will not reload classes in those packages and their subpackages. This is mainly used to exclude classes that produce errors with JavaRebel reloading. JavaRebel will reload classes that are not in the exclude packages and are in an include package. By default all .class classes will be reloaded.
For example-Drebel.packages_exclude=com.mycompany.mypackage,com.thirdparty.theirpackage. - -Drebel.packages_include=PACKAGE1,PACKAGE2,…
- This should be set to a comma-separated list of Java packages. JavaRebel will also reload classes in those packages and their subpackages. This is mainly used to enable JAR file reloading. JavaRebel will reload classes that are not in the exclude packages and are in an include package. By default all .class classes will be reloaded.
For example-Drebel.packages_include=com.mycompany.mypackage,com.thirdparty.theirpackage. - -Drebel.forbid_bypass=true
- Disables dynamic proxy method bypass support in JavaRebel. This should be enabled if you have any kind of trouble with dynamic proxies (e.g. JDK Proxy class, CgLib, Javassist proxies).
- -Drebel.plugin=CLASSNAME
- This should point to a class name that implements this interface. The class will then be instanciated by JavaRebel and
preinit()method will be called before the first class is loaded in the host classloader. - -Drebel.log=true
- Enables debug logging to the JavaRebel.log file. Use when you are having some problems with the JavaRebel and you need to get more context.
- -Drebel.log.perf=true
- Enables additional logging of the performance statistics to the JavaRebel.log file.
