Merge pull request #1777 from marklogic/feature/better-pdc-exception

Added better errors for PDC connection / auth issues

Author: rjrudin

marklogic-client-api/src/main/java/com/marklogic/client/ProgressDataCloudException.java

@@ -0,0 +1,21 @@
+/*
+ * Copyright © 2025 MarkLogic Corporation. All Rights Reserved.
+ */
+package com.marklogic.client;
+
+/**
+ * Added in 7.2.0 to more easily identify runtime exceptions pertaining to issues with connecting and/or
+ * authenticating with ProgressDataCloud.
+ *
+ * @since 7.2.0
+ */
+public class ProgressDataCloudException extends RuntimeException {
+
+	public ProgressDataCloudException(String message) {
+		super(message);
+	}
+
+	public ProgressDataCloudException(String message, Throwable cause) {
+		super(message, cause);
+	}
+}

marklogic-client-api/src/main/java/com/marklogic/client/impl/okhttp/ProgressDataCloudAuthenticationConfigurer.java

@@ -6,6 +6,7 @@
 import com.fasterxml.jackson.databind.JsonNode;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.marklogic.client.DatabaseClientFactory;
+import com.marklogic.client.ProgressDataCloudException;
 import okhttp3.*;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -83,7 +84,7 @@ private Response callTokenEndpoint() {
 			try {
 				return call.execute();
 			} catch (IOException e) {
-				throw new RuntimeException(String.format("Unable to call token endpoint at %s; cause: %s",
+				throw new ProgressDataCloudException(String.format("Unable to call token endpoint at %s; cause: %s",
 					tokenUrl, e.getMessage(), e));
 			}
 		}
@@ -118,10 +119,10 @@ private String getAccessTokenFromResponse(Response response) {
 				responseBody = response.body().string();
 				payload = new ObjectMapper().readTree(responseBody);
 			} catch (IOException ex) {
-				throw new RuntimeException("Unable to get access token; response: " + responseBody, ex);
+				throw new ProgressDataCloudException("Unable to get access token; response: " + responseBody, ex);
 			}
 			if (!payload.has("access_token")) {
-				throw new RuntimeException("Unable to get access token; unexpected JSON response: " + payload);
+				throw new ProgressDataCloudException("Unable to get access token; unexpected JSON response: " + payload);
 			}
 			return payload.get("access_token").asText();
 		}