The eXistdb Package Service bundles some common functions to access locally installed and remote packages and provides endpoint to access those functions.
It allows to:
- list locally installed applications
- list locally installed libs
- list all locally installed packages
- list packages available from remote repository
- install a package
- remove a package
- access the package icon
- read the url of the public eXist-db repository
All available metadata are output as HTML custom elements to provide a 1:1 representation: all elements in the metadata are prefixed with 'repo-' to create a valid HTML5 custom element.
It is a headless application to be used by eXistdb-packagemanager and existdb-dashboard.
Outputs a list of locally installed application and libraries.
URL Path: /packages/local
will return a list of HTML elements in the following format:
<repo-packages>
<repo-app url="http://exist-db.org/couchbase" abbrev="couchbase" type="library" version="0.5.5" status="installed" path="/exist/apps/couchbase/">
<repo-type>library</repo-type>
<repo-title>Couchbase driver</repo-title>
<repo-name>http://exist-db.org/couchbase</repo-name>
<repo-description>The Couchbase Server driver extension for eXist-db provides access to functions and features of the Couchbase Server
using the original Couchbase java client. This extension has NOT been developed by CouchBase and is therefore NOT an offical
driver nor is it supported by CouchBase.</repo-description>
<repo-authors>
<repo-author>Dannes Wessels</repo-author>
</repo-authors>
<repo-abbrev>couchbase</repo-abbrev>
<repo-website>https://github.com/weXsol/Couchbase</repo-website>
<repo-license>GNU-LGPL</repo-license>
<repo-icon src="/exist/apps/existdb-packageservice/package/icon?package=http://exist-db.org/couchbase"> </repo-icon>
<repo-url>/exist/apps/couchbase/</repo-url>
<repo-version>0.5.5</repo-version>
</repo-app>
...more entries...
Outputs a list of locally installed applications.
URL Path: /packages/apps
The format is similar to be above. The type will be "application":
<repo-packages>
<repo-app url="http://exist-db.org/apps/eXide" abbrev="eXide" type="application" version="2.4.1" status="installed" path="/exist/apps/eXide/">
<repo-type>application</repo-type>
<repo-title>eXide - XQuery IDE</repo-title>
<repo-name>http://exist-db.org/apps/eXide</repo-name>
<repo-description>eXide - a web based XQuery IDE</repo-description>
<repo-authors>
<repo-author>Wolfgang Meier</repo-author>
</repo-authors>
<repo-abbrev>eXide</repo-abbrev>
<repo-website>http://exist-db.org/exist/apps/eXide/docs/doc.html</repo-website>
<repo-license>GNU-GPLv3</repo-license>
<repo-icon src="/exist/apps/existdb-packageservice/package/icon?package=http://exist-db.org/apps/eXide"> </repo-icon>
<repo-url>/exist/apps/eXide/</repo-url>
<repo-version>2.4.1</repo-version>
</repo-app>
...more entries...
Outputs a lists of package available from the public repository
packages/remote
Remote packages may contain additional elements like <repo-other>
<repo-packages>
<repo-app url="http://exist-db.org/apps/tei-graphing" abbrev="tei-graphing" type="application" version="0.2" status="available">
<repo-icon src="/exist/apps/existdb-packageservice/resources/images/package.png"> </repo-icon>
<repo-type>application</repo-type>
<repo-title>(TEI) Graphing for eXist-db</repo-title>
<repo-version>0.2</repo-version>
<repo-name>http://exist-db.org/apps/tei-graphing</repo-name>
<repo-description>(TEI) Graphing for eXist-db using libraries for dynamic visualization.</repo-description>
<repo-authors>
<repo-author>Leif-Jöran Olsson</repo-author>
</repo-authors>
<repo-abbrev>tei-graphing</repo-abbrev>
<repo-website></repo-website>
<repo-license>GNU-GPLv3</repo-license>
<repo-requires processor="http://exist-db.org" semver-min="3.0.2"></repo-requires>
<repo-changelog></repo-changelog>
<repo-other>
<repo-version version="0.2-SNAPSHOT" path="exist-tei-graphing-0.2-SNAPSHOT.xar">
<repo-requires processor="http://exist-db.org"></repo-requires>
</repo-version>
<repo-version version="0.1-SNAPSHOT" path="exist-tei-graphing-0.1-SNAPSHOT.xar"></repo-version>
</repo-other>
</repo-app>
/packages/action
Will receive a post request with params from the client application.
For installation of a package the url,abbrev and version must be given.
For removal only the url must be given.
packages/public-url
Will return the http Url where the public eXist-db packages are hosted for distribution. This Url is used by Packagemanager.
All functions accessing packages will test if the user has access to the given package.
Can be configured in configuration.xml. Currently only one server is supported but markup is designed for extending this.
eXistdb Package Service has no login of its own. It is assumed that the using application will provide a login. If called without valid credentials the service will return 'no service' message.
