Changes

Jump to navigation Jump to search
4,291 bytes added ,  15:24, 24 January 2019
no edit summary
This article is part of the [[Getting Started]] Section. It describes how to run XPath/XQuery code from within the [https://www.jetbrains.com/idea IntelliJ IDEA IDE].There are currently two XQuery plugins for IntelliJ IDEA on the market: * The [https://plugins.jetbrains.com/plugin/9757-xquery-support--marklogic-debugger XQuery Support + MarkLogic Debugger] plugin by Grzegorz Ligas.* The [https://plugins.jetbrains.com/plugin/8612-xquery-intellij-plugin xquery-intellij-plugin] by Reece H. Dunn.* '''Note:''' BaseX itself is a highly compliant XQuery 3.1 processor. We strongly encourage you to use the [[Graphical_User_Interface#Text_Editor|XML editor]] integrated into the BaseX GUI to edit and query your XML data!<br/><br/>
=Preparations=
* In the ''New Project'' dialog choose ''Empty Project'' from the left-hand column and click the ''Next'' button.
* Enter a name and location for your project.
* In the project view, create a new XQuery file, either by right-clicking on the project name and choosing ''New''→''XQuery File'' or by selecting ''New''→''XQuery File'' from the File menu.
* Type in your query.
* Click the green ''Run'' button below the IntelliJ IDEA menu bar.
* In the ''Edit Configuration'' dialog choose one of the two data source from the dropdown box, either "BaseX" or "BaseX (native embedded)". If you select "BaseX", make sure that BaseX is up and running.
* Click ''Run'' to execute your query.
 
=xquery-intellij-plugin=
 
This section focuses on Reece H. Dunn's [https://plugins.jetbrains.com/plugin/8612-xquery-intellij-plugin xquery-intellij-plugin].
 
==Installation==
 
After installing IntelliJ IDEA and BaseX, install the xquery-intellij-plugin by one of the following methods:
===From the Start Screen===
* Start IntelliJ IDEA and select ''Configure''→''Plugins''.
* In the Plugins window select the tab ''Marketplace''.
* Type "XQuery" into the ''Search plugins in marketplace'' field.
* Click the ''Install'' button below ''xquery-intellij-plugin''.
* You will be prompted to restart IDEA to load the new plugin.
 
===From the IntelliJ IDEA Menu===
* Select ''Settings/Preferences'' in the ''IntelliJ IDEA'' menu.
* In the Settings/Preferences window select ''Plugins''.
* In the Plugins window select the tab ''Marketplace''.
* Type "XQuery" into the ''Search plugins in marketplace'' field.
* Click the ''Install'' button below ''xquery-intellij-plugin'' plugin.
* You will be prompted to restart IDEA to load the new plugin.
 
==Configuring The Processor==
* Start IntelliJ IDEA and navigate to ''Settings/Preferences'' either using the ''Configure'' button from the start screen or the ''IntelliJ IDEA'' menu.
* In the Settings/Preferences window, expand the ''Languages & Frameworks'' item, select ''XQuery''.
* Make the choices for your system from the dropdown boxes, e.g.:
** <code>Implementation = BaseX</code>
** <code>Implementation version = BaseX 9.1</code>
** <code>Default XQuery version = XQuery 3.1</code>
** <code>Dialect for XQuery 3.0 = BaseX</code>
** <code>Dialect for XQuery 3.1 = BaseX</code>
* Click ''Apply'' to store your XQuery settings and then ''OK'' to exit the dialog.
 
==Querying Your Data==
* To create a new project, choose the ''Create new project'' option from the start screen or select ''New''→''Project...'' from the ''File'' menu.
* In the ''New Project'' dialog choose ''Empty Project'' from the left-hand column and click the ''Next'' button.
* Enter a name and location for your project.
* Click the ''Add Configuration'' button below the IntelliJ IDEA menu bar.
* Expand the Templates list and choose the ''XQuery'' entry.
* In the ''Run/Debug Configurations'' dialog click on the three dots {{Code|...}} next to the ''Query Processor'' dropdown box.
* In the ''Manage Query Processors'' dialog click on the {{Code|+}} button.
* In the ''New Query Processor Instance" dialog, set the following preferences:
** <code>Name = BaseX</code>
** <code>Implementation = BaseX</code> (should be preset!)
** <code>Implementation = BaseX</code>
** <code>JAR File = basex/BaseX.jar</code>
** <code>Hostname = localhost</code>
** <code>Database port = 1984</code>
** <code>Username = admin</code>
** <code>Password = admin</code>
* Click ''OK'' to exit the ''New Query Processor Instance" dialog.
* In the ''Manage Query Processors'' now choose the "BaseX 9.1.1 (BaseX)" entry and click ''OK''.
* The ''Query Processor'' dropdown box in the ''Run/Debug Configurations'' dialog should now also display "BaseX 9.1.1 (BaseX)". If not, select it from the dropdown box.
* Click ''Apply'' and then ''OK'' to close the ''Run/Debug Configurations'' dialog.
 
* In the project view, create a new XQuery file, either by right-clicking on the project name and choosing ''New''→''XQuery File'' or by selecting ''New''→''XQuery File'' from the File menu.
* Type in your query.
administrator, editor
162

edits

Navigation menu