• Requirements
• Usage
  • Library
  • CLI
  • Docker
• Configuration object/file
• How to make API calls
• Development
  • Set-up
  • Run tests
  • Use
• License

• Node.js
• Java VM

The package can be used as a library, CLI, and via Docker.

• Install dependencies: npm install.
• The RMLMapper needs to be available in the root and called rmlmapper.jar. Download it via node bin/download-rmlmapper-cli.js [version].
  • version is optional to get a specific version, e.g. 5.0.0 (default: latest)

The package can be used as a library as follows:

const Api = require('@rmlio/rmlmapper-webapi');
const config = {}; // see below

// Create API.
const api = new Api(config);
api.set('port', config.port);

// Create and launch server.
const server = http.createServer(api);
server.listen(config.port);

The config object looks as follows:

• rmlmapper.path: path to the RMLMapper jar (required).
• rmlmapper.version: version of the used RMLMapper. This is shown on the main page of the API (required).
• baseURL: url of where the API will be available. This is shown on the main page of the API (default: http://localhost + port).
• removeTempFolders: if this is set true, temporary folders are removed once the execution of one call is done (default: true).
• logLevel: log level used by the logger (default: info).
• port: port of the server (default: 4000).
• basePath: the path preceding all routes (default: /).

• Install the server: npm i -g @rmlio/rmlmapper-webapi.
• Start the server: rmlmapper-webapi.
• The server is available at http://localhost:4000 (if port is unchanged).

The following paramaters can be used to configure the server:

Usage: cli [options]

Options:
  -V, --version                    output the version number
  -p, --port [port]                Port of the server (default: 4000).
  -e, --baseURL [url]              Url of the server (default: http://localhost:4000).
  -r, --rmlmapper [path]           Path to the RMLMapper jar (default: rmlmapper.jar).
  --rmlmapper-version [version]    Version of the used RMLMapper.
  -t, --removeTempFolders          True if temp folders should be removed, else false (default: true).
  -b, --basePath [path]            The path preceding all routes (default: /).
  -l, --logLevel [level]           The log level used by the logger (default: info).
  -o, --behind-reverse-proxy       Enable if the server is behind a reverse proxy (e.g., NGINX).
  --rate-limiter-window [minutes]  The window of the rate limiter (default: infinity).
  --rate-limiter-max [integer]     The max requests allowed by the rate limiter (default: infinity).
  -h, --help                       display help for command

Parameters can also be set via a configuration file called config.json, which is located in the current working directory, and contains same options as the config object when using the package as library. An example can be found in config_example.json. The latest version of the RMLMapper is downloaded when running the server if no rmlmapper.path is given. The version is automatically determined.

• Build image: docker build -t rmlmapper-webapi .
• Run container: docker container run -p 4000:4000 rmlmapper-webapi

Parameters can also be set via a configuration file called config.json, which is located in the current working directory, and contains the following settings:

• rmlmapper.path: path to the RMLMapper jar.
• rmlmapper.version: version of the used RMLMapper. This is shown on the main page of the API.
• baseURL: url of where the API will be available. This is shown on the main page of the API.
• removeTempFolders: if this is set true, temporary folders are removed once the execution of one call is done.
• logLevel: log level used by the logger (default: info).
• port: port of the server (default: 4000).
• basePath: the path preceding all routes (default: /).

An example can be found in config_example.json. The latest version of the RMLMapper is downloaded when running the server if no rmlmapper.path is given. The version is automatically determined.

When the server is running you can find the descriptions of the calls at the root of the server (e.g., http://localhost:4000). The calls are also described using the Open API specification in /swagger.yaml.

• Install dependencies: npm install.
• The RMLMapper needs to be available in the root and called rmlmapper.jar. Download via npm run download:rmlmapper [version].
  • version is optional to get a specific version, e.g. 5.0.0 (default: latest)

• Run the tests: npm test. The test framework is Mocha and the code coverage is provided via Istanbul.

• npm start

This code is copyrighted by Ghent University – imec and released under the MIT license.