Add types for all the Databricks error detail types. (#497)

## What changes are proposed in this pull request?

This PR is a first step in adding support for all the Databricks error
detail types. Specifically, this PR introduces AutoValue classes for
each error detail and make sure that these are parsed properly. However,
the types are not exposed yet in the actual DatabricksError exception,
this will come in a subsequent PR.

While it might not look as such, the change in `ApiErrorBody` is
practically a no-op because:

1. The server can only return one error info.
2. Only error info types were extracted from the list of details.

## How is this tested?

Unit tests focused on deserialization.

NO_CHANGELOG=true

Author: renaudhartert-db

databricks-sdk-java/pom.xml

@@ -104,6 +104,12 @@
       <artifactId>jackson-datatype-jsr310</artifactId>
       <version>${jackson.version}</version>
     </dependency>
+    <!-- Jackson Guava module needed to serialize/deserialize AutoValue classes -->
+    <dependency>
+      <groupId>com.fasterxml.jackson.datatype</groupId>
+      <artifactId>jackson-datatype-guava</artifactId>
+      <version>${jackson.version}</version>
+    </dependency>
     <!-- Google Auto Value -->
     <dependency>
       <groupId>com.google.auto.value</groupId>

databricks-sdk-java/src/main/java/com/databricks/sdk/core/DatabricksError.java

@@ -14,8 +14,6 @@
  * unrecoverable way and this exception should be thrown, potentially wrapped in another exception.
  */
 public class DatabricksError extends DatabricksException {
-  private static final String ERROR_INFO_TYPE = "type.googleapis.com/google.rpc.ErrorInfo";
-  private final String message;
   private final Throwable cause;
   private final String errorCode;
   private final int statusCode;
@@ -51,14 +49,13 @@ private DatabricksError(
       List<ErrorDetail> details) {
     super(message, cause);
     this.errorCode = errorCode;
-    this.message = message;
     this.cause = cause;
     this.statusCode = statusCode;
     this.details = details == null ? Collections.emptyList() : details;
   }
 
   public List<ErrorDetail> getErrorInfo() {
-    return this.getDetailsByType(ERROR_INFO_TYPE);
+    return this.getDetailsByType("type.googleapis.com/google.rpc.ErrorInfo");
   }
 
   public String getErrorCode() {

databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ApiErrorBody.java

@@ -1,7 +1,10 @@
 package com.databricks.sdk.core.error;
 
+import com.databricks.sdk.core.error.details.ErrorDetails;
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.Arrays;
+import java.util.Collections;
 import java.util.List;
 
 /**
@@ -21,21 +24,31 @@ public class ApiErrorBody {
 
   public ApiErrorBody() {}
 
+  /**
+   * Constructs an ApiErrorBody from the given parameters.
+   *
+   * <p>The error details are converted to a list of ErrorDetail objects. This only supports the
+   * ErrorInfo type.
+   *
+   * @param errorCode The error code.
+   * @param message The error message.
+   * @param scimDetail The SCIM detail.
+   */
   public ApiErrorBody(
       @JsonProperty("error_code") String errorCode,
       @JsonProperty("message") String message,
       @JsonProperty("detail") String scimDetail,
       @JsonProperty("status") String scimStatus,
       @JsonProperty("scimType") String scimType,
       @JsonProperty("error") String api12Error,
-      @JsonProperty("details") List<ErrorDetail> errorDetails) {
+      @JsonProperty("details") ErrorDetails errorDetails) {
     this.errorCode = errorCode;
     this.message = message;
     this.scimDetail = scimDetail;
     this.scimStatus = scimStatus;
     this.scimType = scimType;
     this.api12Error = api12Error;
-    this.errorDetails = errorDetails;
+    this.errorDetails = fromDetails(errorDetails);
   }
 
   public List<ErrorDetail> getErrorDetails() {
@@ -93,4 +106,26 @@ public String getApi12Error() {
   public void setApi12Error(String api12Error) {
     this.api12Error = api12Error;
   }
+
+  /**
+   * Converts the error details to a list of ErrorDetail objects. This only supports the ErrorInfo
+   * type.
+   *
+   * @param details The error details to convert.
+   * @return A list of ErrorDetail objects.
+   */
+  private static List<ErrorDetail> fromDetails(ErrorDetails details) {
+    if (details == null) {
+      return Collections.emptyList();
+    }
+    if (!details.errorInfo().isPresent()) {
+      return Collections.emptyList();
+    }
+    return Arrays.asList(
+        new ErrorDetail(
+            "type.googleapis.com/google.rpc.ErrorInfo",
+            details.errorInfo().get().reason(),
+            details.errorInfo().get().domain(),
+            details.errorInfo().get().metadata()));
+  }
 }

databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/details/BadRequest.java

@@ -0,0 +1,192 @@
+package com.databricks.sdk.core.error.details;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import com.google.auto.value.AutoValue;
+import java.util.Collections;
+import java.util.List;
+
+/**
+ * BadRequest describes violations in a client request. This error type focuses on the syntactic
+ * aspects of the request.
+ *
+ * <p>BadRequest errors occur when the request format, structure, or content does not meet the
+ * service's requirements. This is different from business logic errors or system failures - it
+ * specifically indicates that the client sent a malformed or invalid request.
+ *
+ * <p>Examples of bad request violations might include:
+ *
+ * <ul>
+ *   <li>Missing required fields
+ *   <li>Invalid field values (wrong type, format, or range)
+ *   <li>Malformed JSON or XML
+ *   <li>Unsupported field combinations
+ *   <li>Invalid enum values
+ *   <li>Field length or size violations
+ * </ul>
+ *
+ * <p>This information helps clients:
+ *
+ * <ul>
+ *   <li>Identify what's wrong with their request
+ *   <li>Fix the request format before retrying
+ *   <li>Understand the service's input requirements
+ *   <li>Implement proper input validation
+ * </ul>
+ */
+@AutoValue
+@JsonDeserialize(builder = AutoValue_BadRequest.Builder.class)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public abstract class BadRequest {
+
+  /**
+   * Describes all field violations in the request.
+   *
+   * <p>This list contains details about each specific field or aspect of the request that violated
+   * the service's requirements. Multiple violations can occur if the request has multiple problems.
+   *
+   * @return the list of field violations
+   */
+  @JsonProperty("field_violations")
+  public abstract List<BadRequestFieldViolation> fieldViolations();
+
+  /**
+   * Creates a new builder for constructing BadRequest instances.
+   *
+   * @return a new builder instance
+   */
+  public static Builder builder() {
+    return new AutoValue_BadRequest.Builder();
+  }
+
+  /** Builder for constructing BadRequest instances. */
+  @AutoValue.Builder
+  @JsonIgnoreProperties(ignoreUnknown = true)
+  public abstract static class Builder {
+
+    /**
+     * Sets the field violations.
+     *
+     * @param fieldViolations the list of field violations
+     * @return this builder for method chaining
+     */
+    @JsonProperty("field_violations")
+    public abstract Builder setFieldViolations(List<BadRequestFieldViolation> fieldViolations);
+
+    /**
+     * Builds the BadRequest instance.
+     *
+     * @return a new BadRequest instance
+     */
+    public BadRequest build() {
+      if (fieldViolations() == null) {
+        setFieldViolations(Collections.emptyList());
+      }
+      return autoBuild();
+    }
+
+    abstract List<BadRequestFieldViolation> fieldViolations();
+
+    abstract BadRequest autoBuild();
+  }
+
+  /**
+   * BadRequestFieldViolation describes a specific field violation in a request.
+   *
+   * <p>Each violation provides details about what specific field or aspect of the request was
+   * invalid and how the client can fix it.
+   */
+  @AutoValue
+  @JsonDeserialize(builder = AutoValue_BadRequest_BadRequestFieldViolation.Builder.class)
+  @JsonIgnoreProperties(ignoreUnknown = true)
+  public abstract static class BadRequestFieldViolation {
+
+    /**
+     * A path leading to a field in the request body.
+     *
+     * <p>This field identifies the specific location of the violation within the request structure.
+     * The path format depends on the request format but typically follows a hierarchical structure.
+     *
+     * <p>Examples of field paths:
+     *
+     * <ul>
+     *   <li>"name" - top-level field
+     *   <li>"user.email" - nested field
+     *   <li>"items[0].id" - array element field
+     *   <li>"metadata.api_key" - deeply nested field
+     *   <li>"settings.notifications.enabled" - multi-level nested field
+     * </ul>
+     *
+     * <p>This path helps clients quickly locate and fix the problematic field in their request.
+     *
+     * @return the path to the violating field
+     */
+    @JsonProperty("field")
+    public abstract String field();
+
+    /**
+     * A description of why the request element is bad.
+     *
+     * <p>This field provides a human-readable explanation of what's wrong with the field and how to
+     * fix it. The description should be clear enough for developers to understand and resolve the
+     * issue.
+     *
+     * <p>Examples of field violation descriptions:
+     *
+     * <ul>
+     *   <li>"Field is required and cannot be empty"
+     *   <li>"Value must be a positive integer"
+     *   <li>"Invalid email format"
+     *   <li>"String length must be between 1 and 100 characters"
+     *   <li>"Unsupported enum value. Must be one of: [A, B, C]"
+     *   <li>"Field cannot contain special characters"
+     *   <li>"Date must be in ISO 8601 format (YYYY-MM-DD)"
+     * </ul>
+     *
+     * @return description of why the field is invalid
+     */
+    @JsonProperty("description")
+    public abstract String description();
+
+    /**
+     * Creates a new builder for constructing BadRequestFieldViolation instances.
+     *
+     * @return a new builder instance
+     */
+    public static Builder builder() {
+      return new AutoValue_BadRequest_BadRequestFieldViolation.Builder();
+    }
+
+    /** Builder for constructing BadRequestFieldViolation instances. */
+    @AutoValue.Builder
+    @JsonIgnoreProperties(ignoreUnknown = true)
+    public abstract static class Builder {
+
+      /**
+       * Sets the field path.
+       *
+       * @param field the path to the violating field
+       * @return this builder for method chaining
+       */
+      @JsonProperty("field")
+      public abstract Builder setField(String field);
+
+      /**
+       * Sets the violation description.
+       *
+       * @param description description of why the field is invalid
+       * @return this builder for method chaining
+       */
+      @JsonProperty("description")
+      public abstract Builder setDescription(String description);
+
+      /**
+       * Builds the BadRequestFieldViolation instance.
+       *
+       * @return a new BadRequestFieldViolation instance
+       */
+      public abstract BadRequestFieldViolation build();
+    }
+  }
+}