Integrating Eclipse
This tutorial is part of the Getting Started Section. It describes how to access BaseX from Eclipse via the oXygen XML Editor plugin. The plugin offers the same features as specified in [Integrating_oXygen]. However, the way to get there from within Eclipse it a little bit different.
Currently, there are two alternatives how to use BaseX in oXygen:
- Resources in BaseX databases can be opened and modified.
- XPath/XQuery 1.0 expressions can be run by the query processor of BaseX.
- Note: BaseX itself is a highly compliant XQuery 3.1 processor. The restriction to XQuery 1.0 arises from the XQJ Interface which is used to establish the connection between oXygen and BaseX. We strongly encourage you to use the XML editor integrated into the BaseX GUI to edit and query your XML data!
Contents
Preparations
- Download and install Eclipse. Note: The current version of the oXygen XML Editor plugin was tested for Eclipse Version 4.8. Please also note that you will require an oXygen license to use the plugin.
- Follow the instructions in the oXygen Manual to install the plugin.
- In Eclipse, click on the oXygen icon in the right upper corner to open the plugin. The XML Project you created during the installation of the plugin should be displayed in the Navigator panel. In this example, it is called BaseXProject.
Access Database Resources
Preparations
- Download one of the BaseX distributions.
- Start BaseX (see Startup).
- Create a BaseX database, if necessary (see Databases).
- Start the BaseX WebDAV service.
Configuration
Note: If you have already integrated BaseX into the oXygen XML Editor itself as described in Integrating_oXygen, your BaseX WebDAV connection will already be available in the plugin.
- In Eclipse, go to menu Eclipse → Preferences. In the Preferences dialog, chose the oXygen XML Editor item, and then the Data Sources subitem.
- In the Connections panel (in the lower half of the screen), click the New button (
+
). - Enter "BaseX WebDAV" as connection name.
- Select "WebDAV (S)FTP" in the Data Source dropdown box.
- Fill in the appropriate connection details as follows:
- Set the WebDAV/FTP URL to
http://localhost:8984/webdav
. - Set the user name to
admin
. - Set the password to
admin
.
- Set the WebDAV/FTP URL to
- Press OK to close the dialog.
- Click Apply and Close to close the Preferences dialog.
- If prompted, restart Eclipse to activate all changes.
You can then access your database file(s) via the Data Source Explorer: Windows → Show View → Data Source Explorer.
Perform Queries
One-Time Setup
Note: If you have already integrated BaseX into the oXygen XML Editor itself as described in Integrating_oXygen, your data sources and connections will already be available in the plugin.
Configuration
- In Eclipse, go to menu Eclipse → Preferences. In the Preferences dialog, chose the oXygen XML Editor item, and then the Data Sources subitem.
- In the Data Sources panel, add a new data source using the New button (
+
). - Enter "BaseX" as name and select XQuery API for Java(XQJ) from the Type dropdown box.
- Add the following JAR files (downloaded in Preparations procedure) with the Add Files Button. The versions of the JAR files may differ.
basex/lib/xqj-api-1.0.jar
basex/lib/xqj2-0.2.0.jar
basex/lib/basex-xqj-9.0.jar
basex/BaseX.jar
, if you want to use BaseX embedded
- Under "Driver class", choose the preferred driver class:
- Embedded:
net.xqj.basex.BaseXXQDataSource
- Client/server:
net.xqj.basex.local.BaseXXQDataSource
- Embedded:
- Click OK.
Configure Connection
- In the Connections section (in the lower half of the Data Source dialog), click New (
+
). - Enter "BaseX XQJ" as name and select "BaseX" as data source.
- If you use the default driver, enter the following values in the Connection Details section:
- port:
1984
- serverName:
localhost
- user:
admin
- password:
admin
- port:
- Click OK to complete the connection configuration.
- Click Apply and Close to close the Preferences dialog.
- If prompted, restart Eclipse to activate all changes.