Developing with Eclipse
- BaseX is being developed with the Eclipse environment. Other IDEs are used as well in our community, but are not supported by our team.
- The EGit plugin is needed to check out the latest sources from our repository within Eclipse.
- For additional comfort and to work with packages other than the main project, the m2eclipse plugin is required, which adds Maven support to Eclipse.
- Additional coding guidelines are defined via Checkstyle and can be integrated with the eclipse-cs plugin.
To check out BaseX and its sub projects from https://github.com/basexdb, proceed as follows:
- Choose the project you like:
- Click on Finish
- Press Run → Run…
- Create a new "Java Application" launch configuration
- Select "basex" as "Project"
- Choose a "Main class" (e.g.,
org.basex.BaseXGUIfor the graphical user interface)
- Launch the project via Run
If the standalone version of Maven is installed,
you can run
mvn compile in the project directory to compile BaseX.
Should you wish to create / package your own jars you can do so by running
By adding the flag
-DskipTests=true you can skip running the JUnit-tests.
java -cp target/classes/org.basex.BaseX to run BaseX.
You can launch the following classes, which are all placed in the
org.basex main package:
- standalone mode
- server instance, waiting for requests
- client instance, interacting with the server
- graphical user interface
-h to have a look at the available command-line options.
For example, you can evaluate XQuery expressions or process database commands without
entering the console.