The provided sample command-line driver can be used to experiment using REST from the command-line.
The command-line driver was written as proof of concept to demonstrate use of the REST API, and is not intended as a primary way of interacting with it.
Source code for the command-line driver is available as an IntelliJ/Maven project in a Bitbucket repository - https://bitbucket.org/deltaxml/docbook-compare-rest-java-cli/. Please customize as needed. This client uses XPath to process results.
For example:
java -jar deltaxml-docbook-rest-client-10.0.0.jar compare docbookFile1.xml docbookFile2.xml out.xml
Docbook Compare REST command-line driver. (C) 2022 DeltaXML Ltd. All rights reserved.
Job running: http://0.0.0.0:8080/api/docbook-compare/v1/jobs/150b9897-d429-4322-928f-2e5272c9366a
Progress:
QUEUED
SUBMITTED
STARTED
INPUTS_LOADING_A
INPUTS_LOADING_B
INPUT_FILTERS
COMPARISON_RUNNING
OUTPUT_FILTERS
SAVING
FINISHED
Result written to out.xml
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:
java -Dhost=http://localhost:1234 -jar deltaxml-docbook-rest-client-10.0.0.jar
In these samples, references to the deltaxml-docbook-rest-client-10.0.0.jar should be modified to match the major.minor.patch version of DocBook Compare you are using.
Also, if using a Windows terminal, the '\' line-continuation character should be replaced with '^' character.