Changes

This page is part of the [[Developer Section]]. It describes how to get the BaseX sources compiled and running on your system. Another article in the documentation describes how to use BaseX as a [[Integrating Eclipse|query processor in Eclipse]]. ==InstallationPrerequisites==

BaseX is developed with the Eclipse environment (other IDEs like IntelliJ IDEA can be used as well). The [https://www.eclipse.org/downloads/ Eclipse IDE for Java Developers] includes the EGit plugin (for [[Git]]) and the m2e plugin (for [[Maven]]). Other plugins we use are: {| class="wikitable" |- valign="top"! Name! Description! Update URL! Eclipse Marketplace|-| [http://eclipse-cs.sourceforge.net eclipse-cs]| Enforces Checkstyle coding standards.| <code><nowiki>http://eclipse-cs.sf.net/update/</nowiki></code>| [https://marketplace.eclipse.org/marketplace-client-intro?mpc_install=150 install]|-| [https://spotbugs.github.io/ SpotBugs]| Analyze project at byte code level| <code><nowiki>https://spotbugs.github.io/eclipse/</nowiki></code>| [https://marketplace.eclipse.org/marketplace-client-intro?mpc_install=3519199 install]|-| [http://www.ucdetector.org/ UCDetector]| Unnecessary code detector| <code><nowiki>http://ucdetector.sourceforge.net/update</nowiki></code>| [https://marketplace.eclipse.org/marketplace-client-intro?mpc_install=661 install]|} =Eclipse Integration=Check Out==

<p>Our [[Git|Git Tutorial]] explains how BaseX is being developed with can be checked out from the [https://github.com/BaseXdb/basex GitHub Repository] and embedded in Eclipse environmentwith EGit. Some styleguidelines are integrated in the sources of BaseX;they are being embedded as soon as you open the projectThe article also demonstrates how git can be used on command-line.</p> <p>The [httpbasex repository contains the following subdirectories://subclipse.tigris.org Subclipse Plugin] # {{Code|basex-core}} is neededthe main projectto check out # {{Code|basex-api}} contains the latest sources from BaseX APIs (XML:DB, bindings in other languages) and HTTP Services ([[Subversion_Repository|our repositoryREST]].Next, we recommend to use the[http://m2eclipse.sonatype.org m2eclipse[RESTXQ]] pluginto add , [[MavenWebDAV]] support to Eclipse.) Some additional guidelines are defined via Checkstyle and can be# {{Code|basex-examples}} includes some examples code for BaseXintegrated with the [http://eclipse# {{Code|basex-cs.sourceforge.net eclipse-cs] tests}} contains several unit and stress testsplugin.</p> <p>To checkout BaseXIf the "Problems" View contains errors or warnings, do the following:</p> #you may need to switch to Java 11 (''FileWindows'' → ''ImportPreferences''#→ ''SVNJava'' → ''Check out Projects from SVNInstalled JREs''). ==Start in Eclipse== #Use the repository [https://svn.uni-konstanz.de/dbis/basex https://svn.uni-konstanz.de/dbis/basex] and click Press ''Run'' → ''BrowseRun…''#Choose the project you like:<br/> Create a new "Java Application" launch configuration ##[https://svn.uni-konstanz.de/dbis/Select "basex/trunk/basex basex] is the main project" as "Project" ##[https://svnChoose a "Main class" (e.uni-konstanzg.de/dbis/basex/trunk/api api] contains the BaseX APIs (XQJ, XMLDB and bindings in other languages) ##[https://svn<code>org.uni-konstanzbasex.deBaseXGUI</dbis/basex/trunk/examples examples] demonstrates some use cases code> for BaseX the graphical user interface) #Click Launch the project via ''FinishRun''

==Alternative=Run BaseX with Eclipse=== #Press Run &raquo; Run&#8230;#Create a new "Java Application" launch configuration #Select "basex" as "Project" #Choose a "Main class" (e.g., <code>org.basex.BaseXGUI</code> for the graphical user interface) #Launch the project via "Run" ===Compile &#38; Run BaseX=== <p>If the standalone version of [http://maven.apache.org Maven] is installed, you can run<code> mvn compile </code>in the project directory to compile BaseX. Should you wish to create / package your own jars you can do so by running <code>mvn package</code>. By adding the flag <code>-DskipTests=true</code> you can skip running the JUnit-tests.</p> <p>Type in<code> java -cp target/classes/org.basex.BaseX </code>to run BaseX.</p> <p>You can launch the following classes, which are all placed in the <code>org.basex</code> main package:</p>

;You may as well use the standalone version of [[Console|BaseXMaven]]: console mode;[[Server Tutorial|BaseXServer]]: server instanceto compile and run the project, waiting for requests;[use other IDEs such as [Server Tutorial|BaseXClient]]https: console mode, interacting with the server;[[GUI Tutorial|BaseXGUI]]:graphical user interface <p>Moreover, try <code>-h</code> to have a look at the available command-line options/www. For example, you can evaluate XQuery expressions or process database commands without entering the consolejetbrains.<com/p>idea/ IntelliJ IDEA].