feat(dcmjs):Support relative bulkdata URIs

Author: wayfarer3130

src/api.js

@@ -1715,6 +1715,25 @@ class DICOMwebClient {
     );
   }
 
+  /**
+   * Generate an absolute URI from a relative URI.
+   * If the URI contains : then it is already absolute, return it.
+   * If the URI starts with /, then just add it after the wadoURL
+   * Otherwise, assume the URL is relative to the wadoURL, and add studies/STUDYUID to it.
+   * @param {string} studyUid to use in the full URL
+   * @param {string} uri to convert to full URL
+   * @returns a URL to the requested resource.
+   */
+  _handleRelativeURI(studyUid, uri) {
+    if (!uri || uri.indexOf(':') !== -1) {
+      return uri;
+    }
+    if (uri[0] === '/') {
+      return this.wadoURL + uri;
+    }
+    return `${this.wadoURL}/studies/${studyUid}/${uri}`;
+  }
+
   /**
    * Retrieves and parses BulkData from a BulkDataURI location.
    * Decodes the multipart encoded data and returns the resulting data
@@ -1732,8 +1751,10 @@ class DICOMwebClient {
     if (!('BulkDataURI' in options)) {
       throw new Error('BulkDataURI is required.');
     }
+    const { StudyInstanceUID, BulkDataURI } = options;
 
-    const url = options.BulkDataURI;
+    // Allow relative URI's, assume it is relative to the studyUID directory
+    const url = this._handleRelativeURI(StudyInstanceUID, BulkDataURI);
     const { mediaTypes, byteRange } = options;
     const { withCredentials = false } = options;
     const { progressCallback = false } = options;