Clients

From BaseX Documentation
Revision as of 12:44, 30 January 2015 by CG (talk | contribs)
Jump to navigation Jump to search

This page is part of the Developer Section. It describes how to communicate with BaseX with other programming languages.

Template:Mark, we have switched from cram-md5 to digest authentication. If a language binding does not work anymore, it will need to be slightly updated. Please have a look at our Server Protocol for more information on the exchanged bytes. Your contributions are welcome!

You can use the following light-weight language bindings to connect to a running BaseX server instance, execute database commands, perform queries, or listen to events.

Most clients provide two modes:

  • Standard Mode: connecting to a server, sending commands
  • Query Mode: defining queries, binding variables, iterative evaluation

Currently, we offer bindings for the following programming languages:

BaseX 7.x, BaseX 8.x and later

...more to come (your contributions are welcome!)

BaseX 7.x (outdated)
  • ActionScript: contributed by Manfred Knobloch
  • C
  • C#
  • Golang: contributed by Christian Baune
  • Haskell: contributed by Leo Wörteler
  • Lisp: contributed by Andy Chambers
  • node.js: contributed by Hans Hübner (deviating from client API)
  • PHP: updated by James Ball
  • Python < 2.7: improved by Arjen van Elteren
  • Qt: contributed by Hendrik Strobelt
  • Rebol: contributed by Sabu Francis
  • Ruby
  • Scala: contributed by Manuel Bernhardt
  • Scala (simple implementation)
  • VB

Many of the interfaces contain the following files:

  • BaseXClient contains the code for creating a session, sending and executing commands and receiving results. An inner Query class facilitates the binding of external variables and iterative query evaluation.
  • Example demonstrates how to send database commands.
  • QueryExample shows you how to evaluate queries in an iterative manner.
  • QueryBindExample shows you how to bind a variable to your query and evaluates the query in an iterative manner.
  • CreateExample shows how new databases can be created by using streams.
  • AddExample shows how documents can be added to a database by using streams.
  • EventExample demonstrates how to watch and unwatch Events.

Changelog

Version 8.0
  • Updated: cram-md5 replaced with digest authentication