Since v6.4 OpenXava includes OpenXava Studio, so you don't need an
additional IDE to work with OpenXava. OpenXava Studio is based on Eclipse
but is lighter and more beautiful. Moreover, you can install any Eclipse
plugin you need on top of OpenXava Studio and change or customize the
visual theme, to have a light theme or color icons, for example. Anyways,
if you prefer to work with your own Eclipse you can. Moreover, OpenXava
projects are WTP projects, so if you use Eclipse IDE for Enterprise Java
Developers, you can add a Tomcat server in the
Servers tab and add
your OpenXava applications to it
.
Install Lombok
OpenXava does not require Lombok, however since v6.5 we use it in the
Getting Started guide and the OpenXava course, so we recommend you install
it.
Follow the official
doc to install Lombok into your Eclipse.
Use OpenXava workspace
After starting your Eclipse it will ask you to select the workspace,
select the
workspace folder included in your OpenXava
distribution:
Probably
Eclipse will complain about the Eclipse workspace version (newer or
older) with a dialog like this:
Don't
worry, just click on Continue.
If
you have done it right, you will see the Addons and OpenXava
projects on the left, inside the Package Explorer, in this way:
If
not, you're not in the OpenXava workspace, use File
> Switch Workspace to
look for the OpenXava workspace again.
In
order that OpenXava workspace works nicely you have to select Dark
theme. In the top menu select Window > Preferences > General
> Appearance:
Choose
Dark for Theme and click on Apply and Close
button.
Create a new Java project
You have to create a new regular Java project, for that choose
File
> New > Project in the menu:
Then select
Java Project and click on
Next:
Now type the project name,
Invoicing
for example, and click the
Finish button:
If you're using Java 9 or better with a recent version of Eclipse, it will
ask you:
Just click on Don't Create.
After this step you have an empty Java project named
Invoicing:
Turn the project into an OpenXava project
Now you must convert your plain Java project into an OpenXava project.
Inside
OpenXava project you have a
CreateNewProject.xml
file, execute it as an Ant build, in this way:
Now refresh your project with F5 and you're ready to follow the getting
started guide: