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/dita-compare-rest-java-cli/. Please customize as needed. This client doesn’t use ‘model’ POJOs corresponding to requests and responses in the API. Instead it processes responses as Strings and use XPath to process results.
For example:
$ java -jar deltaxml-dita-rest-client-11.4.0.jar compare topic samples/in1.dita
samples/in2.dita result.xml
Dita Compare REST command-line driver. (C) 2022 DeltaXML Ltd. All rights reserved.
Job running: http://0.0.0.0:8080/api/dita-compare/v1/jobs/d163f7c7-e3f5-4e9f-9e47-356372fbd372
Progress:
QUEUED
SUBMITTED
STARTED
INPUTS_LOADING_A
INPUTS_LOADING_B
INPUT_FILTERS
COMPARISON_RUNNING
OUTPUT_FILTERS
SAVING
FINISHED
Result written to result.xml
mts example:
$ java -jar deltaxml-dita-rest-client-11.4.0.jar compare mts samples/inA.zip inA/inA.ditamap
samples/inB.zip inB/inB.ditamap result.zip
Dita Compare REST command-line driver. (C) 2022 DeltaXML Ltd. All rights reserved.
Job running: http://0.0.0.0:8080/api/dita-compare/v1/jobs/77d570db-fe12-4e73-b905-357d60c322b1
Progress:
QUEUED
SUBMITTED
STARTED
INPUTS_LOADING_A
INPUTS_LOADING_B
INPUT_FILTERS
COMPARISON_RUNNING
OUTPUT_FILTERS
SAVING
FINISHED
To see your result open result.zip
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-dita-compare-client-1.0.0.jar
In these samples, references to the deltaxml-dita-rest-client-1.0.0.jar should be modified to match the major.minor.patch version of DITA Compare you are using.
Also, if using a Windows terminal, the '\' line-continuation character should be replaced with '^' character.