Skip navigation links

Merge DICOM WS Java Class Library

See: Description

API Packages 
Package Description
com.merge.mcws.dicom  
com.merge.mcws.dicom.qido  
com.merge.mcws.dicom.rscapabilities  
com.merge.mcws.dicom.rsnpi  
com.merge.mcws.dicom.stow  
com.merge.mcws.dicom.ups  
com.merge.mcws.dicom.wado  
com.merge.mcws.interfaces  
com.merge.mcws.utils  
com.merge.mcws.web  
com.merge.mcws.web.handlers  
com.merge.mcws.web.multipart  

The Merge DICOM WS Java Toolkit

Merge DICOM WS Java Toolkit is a light-weight upper layer of Merge DICOM Java Toolkit implementing DICOM WADO features described in the DICOM Standard for Web Services. Key features include: Merge DICOM WS Java Toolkit is created as an extension of the Merge DICOM Java Toolkit to provide an access to DICOM objects through web interfaces for 3rd party applications. As a toolkit it is built on top of the existing Merge DICOM Java Toolkit and re-uses its basic architecture and features (see Merge DICOM Java Toolkit documentation for more details).

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.

Development Platform Requirements

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)

Sample Applications

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.

Skip navigation links
Merge DICOM WS Toolkit Version: 5.19.0.0

Copyright © 2023 Merge Healthcare Solutions Inc. All Rights Reserved.