Testing Using Command Line Driver

The provided command-line driver can be used to experiment using REST from the command-line. The command-line driver demonstrates the use of the REST API, and provides a simple introduction to it.

The command-line driver is included in the distribution zip alongside the main DeltaNova jar and jar for the REST server.

The functionality of the REST command-line driver is similar to the Java API-based command-line driver.

For example:

$ java -jar deltanova-rest-client-year.x.y.z.jar describe diffreport
DeltaNova REST command-line driver

Copyright (c) 2026 Deltaman Group Ltd. All rights reserved.

Pipeline ID: diffreport

Short Description:
[DXP] XML Compare, output HTML folding report
Full Description:
[Uses PipelinedComparatorS9] This configuration is used to produce a HTML folding differences report to be viewed in a browser.

Pipeline Parameters:
 Name                           | Type      | Default Value        | Description
--------------------------------+-----------+----------------------+---------------------------------------------------
 Preserve Whitespace            | boolean   | false                | whether to normalise whitespace before comparison
 Word By Word                   | boolean   | false                | whether to compare PCDATA in a more detailed way
 Enhanced Match 1               | boolean   | true                 | whether to use the 4.x enhanced matcher that is tailored to comparing documents
 add-all-namespace-declarations | boolean   | false                | If true, all namespaces in rendering are declared in-situ - otherwise, only root element namespaces are declared
 minimize-unchanged-display     | boolean   | false                | Collapse and do not embed unchanged subtrees in result - helps minimize file size
 no-fold-size                   | string    | 50                   | Childless nodes of character-length less than this are shown in full - and are not foldable
 important-attribute-list       | string    | id,name,property,key | Comma-separated list of attributes that are important for element alignment purposes
--------------------------------+-----------+----------------------+---------------------------------------------------
$
$
$ java -jar deltanova-rest-client-year.x.y.z.jar compare diffreport samples/WordByWord/build.xml samples/XInclude/build.xml bdiff.html
DeltaXML XML Compare REST Beta Driver. (C) 2022 DeltaXML Ltd. All rights reserved.
Progress:   QUEUED STARTED INPUTS_LOADING_A INPUTS_LOADING_B INPUT_FILTERS COMPARISON_RUNNING OUTPUT_FILTERS SAVING FINISHED
Result written to bdiff.html
$ open bdiff.html

The client defaults to http://localhost:8080 but this can be changed by using the host property.

For example, if the REST service is running on port 1234 instead of 8080:

Bash

java -jar -Dhost=http://localhost:1234 deltanova-rest-client-year.x.y.z.jar

In these samples, references to the deltanova-rest-client-year.x.y.z.jar should be modified to match the year.major.minor.patch version of DeltaNova you are using.

Also, if using a Windows terminal, the \ line-continuation character must be replaced with the ^ character.