See: Description
The following topics provide helpful information for application developers using the Merge DICOM WS Java toolkit:
Merge DICOM WS Java Toolkit is designed over Merge DICOM Java Toolkit (version 5.1 or later) and used to facilitate the accessing of DICOM persistent objects through the web services based on HTTP/HTTPS protocols. The toolkit translates HTTP GET/POST requests into DICOM representations, provides the access to the DICOM retrieve/query/storage service using C-FIND, C-MOVE, C-STORE commands and generates corresponding HTTP responses.
The following figure presents an interaction diagram of Web DICOM client and Web DICOM server for DICOM HTTP GET request.
Merge DICOM WS Toolkit generates DICOM queries from HTTP requests to the DICOM service and vice-versa to convert DICOM persistent objects into HTTP responses. It allows the user to define and configure the services for DICOM retrieve, storage, rendering and cache operations. DICOM services are used to query/retrieve/render DICOM persistent objects from the DICOM Provider, whereas a cache service might be used for the temporary storage and access of DICOM data for repeated requests.
Merge DICOM WS Java Toolkit is build as a single mcws.jar JAR file. To use it properly the user would need all Mergecom DICOM Java Toolkit binary and configuration files (release 5.1 or higher). The list of required files could be found in Merge DICOM Java Toolkit documentation.
Merge DICOM WS Java Toolkit is developed using Java 8 SE and therefore might be used on all platform supporting Java 8 and Mergecom DICOM Java toolkit with C/C++ toolkit runtime library (such as Linux 32, Linux 64, Windows 32 and Windows 64).
To handle low level HTTP based operations the toolkit uses Apache HttpComponents (https://hc.apache.org) and Apache Commons IO (https://commons.apache.org/proper/commons-io) libraries, which are not the part of Mergecom DICOM WS Java Toolkit release. It is the user's obligation to deploy the required versions of Apache HttpComponents and Commons IO to run Merge DICOM WS Java Toolkit successfully.
The following library files are required:
Apache HttpComponents Client (version 4.4 or higher)
Apache HttpComponents Core (version 4.4 or higher)
Apache Commons IO (version 2.4 or higher)
Included samples with open source code provide useful examples of how to apply Merge DICOM WS Toolkit for constructing user DICOM applications.
The samples are written in Java and show how to generate DICOM HTTP requests (WADO-RS, WADO-URI, STOW-RS and QIDO-RS), process these requests through self-host HTTP server, use the registered DICOM services and provide the relevant DICOM WADO responses.
While these sample applications are rather basic in features and user interface, they illustrate how to use the Mergecom Java WS Toolkit classes to handle DICOM HTTP requests and perform DICOM service operations.