Modify OpenXava code

You can modify the OpenXava code to adapt it to your needs, fix a bug, add a new feature, etc.

Since v6.4

You have to define OpenXava.buildOpenXava (or OpenXava.buildAddons) in External Tools of Eclipse (OpenXava Studio). To learn how to run and define Ant targets in Eclipse follow these instructions.

You need a JDK to run the Ant targets. In Eclipse go to External Tools > OpenXava.buildOpenXava (or buildAddons) > JRE and choose a JDK. Sometimes it can fails if the tools.jar in the classpath does not match the used JDK.

If you have problems compiling with accents go to External Tools > OpenXava.buildOPenxava (or buildAddons) > Common > Encoding : ISO-8859-1 (not needed since v6.5.2)

To modify OpenXava Java code, XML or i18n files:

Modify the code on OpenXava/src, OpenXava/xava or OpenXava/i18n. These are not source code folders for Eclipse, so Eclipse doesn't compile them.
Execute the Ant target buildOpenXava from OpenXava/build.xml. It compiles the OpenXava Java code and creates openxava.jar.
Refresh OpenXava project in Eclipse (F5).
Execute the Ant target updateOX from the build.xml of your own project. This copy the new openxava.jar to your project.
Refresh your own project in Eclipse (F5).

To modify Addons Java code or XML:

Modify the code on Addon/src or Addons/xava. These are not source code folders for Eclipse, so Eclipse doesn't compile them.
Execute the Ant target buildAddons from OpenXava/build.xml. It compiles the Addons Java code and copy XML code.
Refresh Addons project in Eclipse (F5).
Execute the Ant target updateOX from the build.xml of your own project.
Refresh your own project in Eclipse (F5).

To modify JSP/HTML/JavaScript/CSS:

Modify the code on OpenXava/web.
Execute the Ant target updateOX from the build.xml of your own project. This copy all the web resources to your project.

Since v6.4 though you can still navigate to OpenXava code from your own code inside Eclipse, you cannot edit that code directly, it's read only. So, you have to look for that class in OpenXava/src yourself, modify it and follow the above steps.

Until v6.3.2

To modify OpenXava Java code, XML or i18n files:

Modify the code on OpenXava/src, OpenXava/xava or OpenXava/i18n.
Press the Build All button or Ctrl-B.
Execute the Ant target updateOX from the build.xml of your own project. This create a new openxava.jar into your project.
Refresh your own project in Eclipse (F5).

To modify Addons Java code or XML:

Modify the code on Addon/src or Addons/xava.
Press the Build All button or Ctrl-B.
Execute the Ant target updateOX from the build.xml of your own project.
Refresh your own project in Eclipse (F5).

To modify JSP/HTML/JavaScript/CSS:

Modify the code on OpenXava/web.
Execute the Ant target updateOX from the build.xml of your own project. This copy all the web resources to your project.