From 5b4e5ded38596333003647dbd5a4eb6c3a02f740 Mon Sep 17 00:00:00 2001 From: Ubuntu Date: Wed, 10 Dec 2025 21:16:19 +0000 Subject: [PATCH] Add internal API annotation --- NEXT_CHANGELOG.md | 5 +++ .../com/databricks/sdk/core/ApiClient.java | 2 ++ .../sdk/core/AzureCliCredentialsProvider.java | 2 ++ .../databricks/sdk/core/AzureEnvironment.java | 2 ++ .../sdk/core/BasicCredentialsProvider.java | 2 ++ .../com/databricks/sdk/core/BodyLogger.java | 2 ++ .../databricks/sdk/core/CliTokenSource.java | 2 ++ .../sdk/core/ConfigAttributeAccessor.java | 2 ++ .../com/databricks/sdk/core/ConfigLoader.java | 2 ++ .../sdk/core/CredentialsProvider.java | 32 +++++++++++++++++++ .../DatabricksCliCredentialsProvider.java | 2 ++ .../sdk/core/DatabricksEnvironment.java | 2 ++ .../sdk/core/DefaultCredentialsProvider.java | 2 ++ .../GoogleCredentialsCredentialsProvider.java | 2 ++ .../sdk/core/GoogleIdCredentialsProvider.java | 2 ++ .../GrpcTranscodingQueryParamsSerializer.java | 2 ++ .../NotebookNativeCredentialsProvider.java | 2 ++ .../sdk/core/PatCredentialsProvider.java | 2 ++ .../com/databricks/sdk/core/ProxyConfig.java | 3 ++ .../sdk/core/commons/CommonsHttpClient.java | 2 ++ .../sdk/core/error/AbstractErrorMapper.java | 2 ++ .../sdk/core/error/ApiErrorBody.java | 2 ++ .../databricks/sdk/core/error/ApiErrors.java | 2 ++ .../sdk/core/error/ErrorOverride.java | 2 ++ .../sdk/core/error/PrivateLinkInfo.java | 2 ++ .../details/ErrorDetailsDeserializer.java | 2 ++ .../error/details/ErrorDetailsSerializer.java | 2 ++ .../databricks/sdk/core/http/Encoding.java | 2 ++ .../databricks/sdk/core/http/FormRequest.java | 2 ++ .../databricks/sdk/core/http/HttpClient.java | 2 ++ .../com/databricks/sdk/core/http/Request.java | 2 ++ .../sdk/core/http/RequestOptions.java | 2 ++ .../databricks/sdk/core/http/Response.java | 2 ++ .../sdk/core/oauth/AuthParameterPosition.java | 3 ++ .../core/oauth/AzureDevOpsIDTokenSource.java | 2 ++ .../AzureGithubOidcCredentialsProvider.java | 2 ++ ...reServicePrincipalCredentialsProvider.java | 2 ++ .../sdk/core/oauth/DataPlaneTokenSource.java | 2 ++ .../sdk/core/oauth/EndpointTokenSource.java | 2 ++ .../sdk/core/oauth/EnvVarIDTokenSource.java | 2 ++ .../sdk/core/oauth/ErrorTokenSource.java | 2 ++ .../ExternalBrowserCredentialsProvider.java | 2 ++ .../sdk/core/oauth/FileIDTokenSource.java | 2 ++ .../sdk/core/oauth/FileTokenCache.java | 2 ++ .../sdk/core/oauth/GithubIDTokenSource.java | 2 ++ ...2MServicePrincipalCredentialsProvider.java | 2 ++ .../sdk/core/oauth/OidcTokenSource.java | 2 ++ .../core/oauth/OpenIDConnectEndpoints.java | 2 ++ .../sdk/core/oauth/SessionCredentials.java | 2 ++ .../oauth/SessionCredentialsTokenSource.java | 2 ++ .../sdk/core/oauth/TokenCacheUtils.java | 2 ++ .../sdk/core/oauth/TokenEndpointClient.java | 2 ++ .../RequestBasedRetryStrategyPicker.java | 2 ++ .../databricks/sdk/core/retry/RetryUtils.java | 2 ++ .../databricks/sdk/core/utils/AzureUtils.java | 2 ++ .../sdk/core/utils/ClockSupplier.java | 2 ++ .../com/databricks/sdk/core/utils/Cloud.java | 3 ++ .../core/utils/CustomCloseInputStream.java | 2 ++ .../sdk/core/utils/CustomRoutePlanner.java | 2 ++ .../sdk/core/utils/Environment.java | 2 ++ .../sdk/core/utils/GoogleUtils.java | 2 ++ .../sdk/core/utils/LinuxUtilities.java | 2 ++ .../sdk/core/utils/MacOSUtilities.java | 2 ++ .../sdk/core/utils/OSUtilities.java | 2 ++ .../databricks/sdk/core/utils/OSUtils.java | 2 ++ .../sdk/core/utils/ProtobufModule.java | 2 ++ .../databricks/sdk/core/utils/ProxyUtils.java | 2 ++ .../databricks/sdk/core/utils/SerDeUtils.java | 2 ++ .../sdk/core/utils/SystemTimer.java | 3 ++ .../com/databricks/sdk/core/utils/Timer.java | 3 ++ .../sdk/core/utils/UtcClockSupplier.java | 2 ++ .../sdk/core/utils/WindowsUtilities.java | 2 ++ .../databricks/sdk/support/InternalApi.java | 15 +++++++++ 73 files changed, 197 insertions(+) create mode 100644 databricks-sdk-java/src/main/java/com/databricks/sdk/support/InternalApi.java diff --git a/NEXT_CHANGELOG.md b/NEXT_CHANGELOG.md index 8f5e9e908..a92cd0f2b 100644 --- a/NEXT_CHANGELOG.md +++ b/NEXT_CHANGELOG.md @@ -10,6 +10,11 @@ ### Documentation +* Add `@InternalApi` annotation to clarify the public API surface. Classes + marked with `@InternalApi` are intended for internal use only and may change + without notice. Only unmarked classes (e.g., `DatabricksConfig`, exceptions, + error types, extension interfaces) are part of the stable public API. + ### Internal Changes ### API Changes diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ApiClient.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ApiClient.java index 20ebad038..fe3dc36c9 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ApiClient.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ApiClient.java @@ -14,6 +14,7 @@ import com.databricks.sdk.core.utils.SystemTimer; import com.databricks.sdk.core.utils.Timer; import com.databricks.sdk.support.Header; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.core.JsonProcessingException; import com.fasterxml.jackson.databind.JavaType; import com.fasterxml.jackson.databind.ObjectMapper; @@ -31,6 +32,7 @@ * Simplified REST API client with retries, JSON POJO SerDe through Jackson and exception POJO * guessing */ +@InternalApi public class ApiClient { public static class Builder { private Timer timer; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/AzureCliCredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/AzureCliCredentialsProvider.java index 7087147cf..7e67ca72e 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/AzureCliCredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/AzureCliCredentialsProvider.java @@ -4,11 +4,13 @@ import com.databricks.sdk.core.oauth.OAuthHeaderFactory; import com.databricks.sdk.core.oauth.Token; import com.databricks.sdk.core.utils.AzureUtils; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.databind.ObjectMapper; import java.util.*; import org.slf4j.Logger; import org.slf4j.LoggerFactory; +@InternalApi public class AzureCliCredentialsProvider implements CredentialsProvider { private final ObjectMapper mapper = new ObjectMapper(); private static final Logger LOG = LoggerFactory.getLogger(AzureCliCredentialsProvider.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/AzureEnvironment.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/AzureEnvironment.java index 32614831d..d133d01f7 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/AzureEnvironment.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/AzureEnvironment.java @@ -1,5 +1,6 @@ package com.databricks.sdk.core; +import com.databricks.sdk.support.InternalApi; import java.util.HashMap; import java.util.Map; @@ -10,6 +11,7 @@ * resources vary depending on the cloud environment: public, germany, govcloud, or china. Depending * on the operation, tokens scoped to a specific endpoint are needed. */ +@InternalApi public class AzureEnvironment { private String name; private String serviceManagementEndpoint; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/BasicCredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/BasicCredentialsProvider.java index 02a25f8ac..bf396ed54 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/BasicCredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/BasicCredentialsProvider.java @@ -1,9 +1,11 @@ package com.databricks.sdk.core; +import com.databricks.sdk.support.InternalApi; import java.util.Base64; import java.util.HashMap; import java.util.Map; +@InternalApi public class BasicCredentialsProvider implements CredentialsProvider { public static final String BASIC = "basic"; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/BodyLogger.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/BodyLogger.java index d0c2a5b25..c964152cf 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/BodyLogger.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/BodyLogger.java @@ -1,5 +1,6 @@ package com.databricks.sdk.core; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.core.JsonProcessingException; import com.fasterxml.jackson.core.TreeNode; import com.fasterxml.jackson.databind.JsonNode; @@ -7,6 +8,7 @@ import com.fasterxml.jackson.databind.node.ArrayNode; import java.util.*; +@InternalApi class BodyLogger { private final Set redactKeys = new HashSet() { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/CliTokenSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/CliTokenSource.java index d3fa200f4..db0678331 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/CliTokenSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/CliTokenSource.java @@ -4,6 +4,7 @@ import com.databricks.sdk.core.oauth.TokenSource; import com.databricks.sdk.core.utils.Environment; import com.databricks.sdk.core.utils.OSUtils; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.ObjectMapper; import java.io.IOException; @@ -18,6 +19,7 @@ import java.util.List; import org.apache.commons.io.IOUtils; +@InternalApi public class CliTokenSource implements TokenSource { private List cmd; private String tokenTypeField; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ConfigAttributeAccessor.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ConfigAttributeAccessor.java index 06502b508..bfda43d73 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ConfigAttributeAccessor.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ConfigAttributeAccessor.java @@ -1,10 +1,12 @@ package com.databricks.sdk.core; +import com.databricks.sdk.support.InternalApi; import java.lang.reflect.Field; import java.time.Duration; import java.util.Map; import java.util.Objects; +@InternalApi class ConfigAttributeAccessor { private final ConfigAttribute configAttribute; private final Field field; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ConfigLoader.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ConfigLoader.java index 47779d0ee..ae531ffc0 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ConfigLoader.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ConfigLoader.java @@ -1,6 +1,7 @@ package com.databricks.sdk.core; import com.databricks.sdk.core.utils.Environment; +import com.databricks.sdk.support.InternalApi; import java.io.FileNotFoundException; import java.io.FileReader; import java.io.IOException; @@ -15,6 +16,7 @@ import org.slf4j.Logger; import org.slf4j.LoggerFactory; +@InternalApi public class ConfigLoader { private static final Logger LOG = LoggerFactory.getLogger(ConfigLoader.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/CredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/CredentialsProvider.java index bcbc415ba..66c95051f 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/CredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/CredentialsProvider.java @@ -1,7 +1,39 @@ package com.databricks.sdk.core; +/** + * CredentialsProvider is an interface that provides a HeaderFactory to authenticate requests to the + * Databricks API. + * + *

Users can implement this interface to provide custom authentication mechanisms. Once + * implemented, the custom provider can be set on {@link DatabricksConfig} using {@link + * DatabricksConfig#setCredentialsProvider(CredentialsProvider)}. + * + *

Note: The methods in this interface are called internally by the SDK clients + * (WorkspaceClient and AccountClient) during request authentication. Users implementing this + * interface should not call these methods directly. + */ public interface CredentialsProvider { + /** + * Returns the authentication type identifier for this credentials provider. + * + *

This method is called internally by the SDK and should not be invoked directly by + * users. It is used for logging and user-agent identification purposes. + * + * @return the authentication type as a string + */ String authType(); + /** + * Creates and returns a new HeaderFactory to authenticate requests to the Databricks API. + * + *

This method is called internally by the SDK during client initialization and should + * not be invoked directly by users. The SDK will call this method to obtain a HeaderFactory that + * will be used to add authentication headers to each API request. + * + *

Note: A new HeaderFactory instance is returned on each invocation. + * + * @param config the Databricks configuration to use for authentication + * @return a new HeaderFactory configured for authenticating API requests + */ HeaderFactory configure(DatabricksConfig config); } diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/DatabricksCliCredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/DatabricksCliCredentialsProvider.java index 8c319cd63..687ec1dd7 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/DatabricksCliCredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/DatabricksCliCredentialsProvider.java @@ -3,10 +3,12 @@ import com.databricks.sdk.core.oauth.CachedTokenSource; import com.databricks.sdk.core.oauth.OAuthHeaderFactory; import com.databricks.sdk.core.utils.OSUtils; +import com.databricks.sdk.support.InternalApi; import java.util.*; import org.slf4j.Logger; import org.slf4j.LoggerFactory; +@InternalApi public class DatabricksCliCredentialsProvider implements CredentialsProvider { private static final Logger LOG = LoggerFactory.getLogger(DatabricksCliCredentialsProvider.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/DatabricksEnvironment.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/DatabricksEnvironment.java index d8cecc9fd..0361dc55f 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/DatabricksEnvironment.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/DatabricksEnvironment.java @@ -1,9 +1,11 @@ package com.databricks.sdk.core; import com.databricks.sdk.core.utils.Cloud; +import com.databricks.sdk.support.InternalApi; import java.util.Arrays; import java.util.List; +@InternalApi public class DatabricksEnvironment { private Cloud cloud; private String dnsZone; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/DefaultCredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/DefaultCredentialsProvider.java index 9cd580a43..59ec6eca0 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/DefaultCredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/DefaultCredentialsProvider.java @@ -1,6 +1,7 @@ package com.databricks.sdk.core; import com.databricks.sdk.core.oauth.*; +import com.databricks.sdk.support.InternalApi; import com.google.common.base.Strings; import java.util.ArrayList; import java.util.List; @@ -13,6 +14,7 @@ * Personal Access Tokens (PAT), OAuth, Azure, Google, and OpenID Connect (OIDC). The provider * attempts each authentication method in sequence until a valid credential is obtained. */ +@InternalApi public class DefaultCredentialsProvider implements CredentialsProvider { private static final Logger LOG = LoggerFactory.getLogger(DefaultCredentialsProvider.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/GoogleCredentialsCredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/GoogleCredentialsCredentialsProvider.java index 06f998d45..755c1b331 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/GoogleCredentialsCredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/GoogleCredentialsCredentialsProvider.java @@ -3,6 +3,7 @@ import static com.databricks.sdk.core.utils.GoogleUtils.GCP_SCOPES; import static com.databricks.sdk.core.utils.GoogleUtils.SA_ACCESS_TOKEN_HEADER; +import com.databricks.sdk.support.InternalApi; import com.google.auth.oauth2.*; import com.google.auth.oauth2.IdTokenProvider.Option; import java.io.ByteArrayInputStream; @@ -14,6 +15,7 @@ import org.slf4j.Logger; import org.slf4j.LoggerFactory; +@InternalApi public class GoogleCredentialsCredentialsProvider implements CredentialsProvider { private static final Logger LOG = diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/GoogleIdCredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/GoogleIdCredentialsProvider.java index 8dce1440b..c51dfd4cc 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/GoogleIdCredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/GoogleIdCredentialsProvider.java @@ -3,6 +3,7 @@ import static com.databricks.sdk.core.utils.GoogleUtils.GCP_SCOPES; import static com.databricks.sdk.core.utils.GoogleUtils.SA_ACCESS_TOKEN_HEADER; +import com.databricks.sdk.support.InternalApi; import com.google.auth.oauth2.GoogleCredentials; import com.google.auth.oauth2.IdTokenCredentials; import com.google.auth.oauth2.IdTokenProvider; @@ -12,6 +13,7 @@ import org.slf4j.Logger; import org.slf4j.LoggerFactory; +@InternalApi public class GoogleIdCredentialsProvider implements CredentialsProvider { private static final Logger LOG = LoggerFactory.getLogger(GoogleIdCredentialsProvider.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/GrpcTranscodingQueryParamsSerializer.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/GrpcTranscodingQueryParamsSerializer.java index 80ddc735c..6c242c474 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/GrpcTranscodingQueryParamsSerializer.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/GrpcTranscodingQueryParamsSerializer.java @@ -1,5 +1,6 @@ package com.databricks.sdk.core; +import com.databricks.sdk.support.InternalApi; import com.databricks.sdk.support.QueryParam; import com.fasterxml.jackson.annotation.JsonProperty; import java.lang.reflect.Field; @@ -16,6 +17,7 @@ * href="https://cloud.google.com/endpoints/docs/grpc-service-config/reference/rpc/google.api#google.api.HttpRule">the * documentation for gRPC transcoding for more details. */ +@InternalApi public class GrpcTranscodingQueryParamsSerializer { public static class QueryParamPair { private final String key; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/NotebookNativeCredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/NotebookNativeCredentialsProvider.java index bebfbce8b..ef6571e61 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/NotebookNativeCredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/NotebookNativeCredentialsProvider.java @@ -1,5 +1,6 @@ package com.databricks.sdk.core; +import com.databricks.sdk.support.InternalApi; import java.lang.reflect.Field; import java.lang.reflect.InvocationTargetException; import java.util.*; @@ -14,6 +15,7 @@ * the token. This token should be available wherever the DBUtils API is accessible (i.e. in the * Spark driver). */ +@InternalApi public class NotebookNativeCredentialsProvider implements CredentialsProvider { private static final Logger LOG = LoggerFactory.getLogger(NotebookNativeCredentialsProvider.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/PatCredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/PatCredentialsProvider.java index 2da861099..710678396 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/PatCredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/PatCredentialsProvider.java @@ -1,8 +1,10 @@ package com.databricks.sdk.core; +import com.databricks.sdk.support.InternalApi; import java.util.HashMap; import java.util.Map; +@InternalApi public class PatCredentialsProvider implements CredentialsProvider { public static final String PAT = "pat"; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ProxyConfig.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ProxyConfig.java index 8374bb3a5..5086a7be0 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ProxyConfig.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/ProxyConfig.java @@ -1,5 +1,8 @@ package com.databricks.sdk.core; +import com.databricks.sdk.support.InternalApi; + +@InternalApi public class ProxyConfig { private String host; private Integer port; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/commons/CommonsHttpClient.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/commons/CommonsHttpClient.java index fb4817326..c2ad6b65d 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/commons/CommonsHttpClient.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/commons/CommonsHttpClient.java @@ -10,6 +10,7 @@ import com.databricks.sdk.core.http.Response; import com.databricks.sdk.core.utils.CustomCloseInputStream; import com.databricks.sdk.core.utils.ProxyUtils; +import com.databricks.sdk.support.InternalApi; import java.io.IOException; import java.io.InputStream; import java.net.MalformedURLException; @@ -37,6 +38,7 @@ import org.slf4j.Logger; import org.slf4j.LoggerFactory; +@InternalApi public class CommonsHttpClient implements HttpClient { /** * Builder for CommonsHttpClient. This class is used to construct instances of CommonsHttpClient diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/AbstractErrorMapper.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/AbstractErrorMapper.java index d40758f8e..cf0c81853 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/AbstractErrorMapper.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/AbstractErrorMapper.java @@ -3,11 +3,13 @@ import com.databricks.sdk.core.DatabricksError; import com.databricks.sdk.core.error.details.ErrorDetails; import com.databricks.sdk.core.http.Response; +import com.databricks.sdk.support.InternalApi; import java.util.HashMap; import java.util.Map; import org.slf4j.Logger; import org.slf4j.LoggerFactory; +@InternalApi abstract class AbstractErrorMapper { private static final Logger LOG = LoggerFactory.getLogger(AbstractErrorMapper.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ApiErrorBody.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ApiErrorBody.java index 167c36d02..6fb2255cf 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ApiErrorBody.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ApiErrorBody.java @@ -1,6 +1,7 @@ package com.databricks.sdk.core.error; import com.databricks.sdk.core.error.details.ErrorDetails; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; @@ -10,6 +11,7 @@ *

Unknown properties in the response should be ignored. */ @JsonIgnoreProperties(ignoreUnknown = true) +@InternalApi public class ApiErrorBody { private String errorCode; private String message; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ApiErrors.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ApiErrors.java index 249b0b1a8..5b815cc98 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ApiErrors.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ApiErrors.java @@ -4,6 +4,7 @@ import com.databricks.sdk.core.DatabricksException; import com.databricks.sdk.core.error.details.ErrorDetails; import com.databricks.sdk.core.http.Response; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.databind.ObjectMapper; import java.io.*; import java.nio.charset.StandardCharsets; @@ -12,6 +13,7 @@ import org.apache.commons.io.IOUtils; /** Helper methods for inspecting the response and errors thrown during API requests. */ +@InternalApi public class ApiErrors { private static final ObjectMapper MAPPER = new ObjectMapper(); private static final Pattern HTML_ERROR_REGEX = Pattern.compile("

(.*)
"); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ErrorOverride.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ErrorOverride.java index 344d40aab..99c1d2815 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ErrorOverride.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ErrorOverride.java @@ -4,9 +4,11 @@ import com.databricks.sdk.core.DatabricksException; import com.databricks.sdk.core.error.details.ErrorDetails; import com.databricks.sdk.core.http.Response; +import com.databricks.sdk.support.InternalApi; import java.lang.reflect.Constructor; import java.util.regex.Pattern; +@InternalApi public class ErrorOverride { private final String debugName; private final Pattern pathRegex; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/PrivateLinkInfo.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/PrivateLinkInfo.java index f64a85d53..ccb0227b2 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/PrivateLinkInfo.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/PrivateLinkInfo.java @@ -4,9 +4,11 @@ import com.databricks.sdk.core.error.details.ErrorDetails; import com.databricks.sdk.core.http.Response; import com.databricks.sdk.core.utils.Cloud; +import com.databricks.sdk.support.InternalApi; import java.util.HashMap; import java.util.Map; +@InternalApi public class PrivateLinkInfo { private final String serviceName; private final String endpointName; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/details/ErrorDetailsDeserializer.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/details/ErrorDetailsDeserializer.java index c8c029e1e..16ce6f9e6 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/details/ErrorDetailsDeserializer.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/details/ErrorDetailsDeserializer.java @@ -1,5 +1,6 @@ package com.databricks.sdk.core.error.details; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.core.JsonParser; import com.fasterxml.jackson.databind.DeserializationContext; import com.fasterxml.jackson.databind.JsonDeserializer; @@ -15,6 +16,7 @@ * Custom deserializer for ErrorDetails that converts an array of JSON objects into an ErrorDetails * object. */ +@InternalApi public class ErrorDetailsDeserializer extends JsonDeserializer { private static final String ERROR_INFO_TYPE = "type.googleapis.com/google.rpc.ErrorInfo"; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/details/ErrorDetailsSerializer.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/details/ErrorDetailsSerializer.java index 1f8f054a9..2a5b04762 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/details/ErrorDetailsSerializer.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/details/ErrorDetailsSerializer.java @@ -1,5 +1,6 @@ package com.databricks.sdk.core.error.details; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.core.JsonGenerator; import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.JsonSerializer; @@ -12,6 +13,7 @@ * Custom serializer for ErrorDetails that converts the object back to the array format expected by * the ErrorDetailsDeserializer. */ +@InternalApi public class ErrorDetailsSerializer extends JsonSerializer { @Override diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/Encoding.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/Encoding.java index fc2fea902..515a49245 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/Encoding.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/Encoding.java @@ -1,5 +1,6 @@ package com.databricks.sdk.core.http; +import com.databricks.sdk.support.InternalApi; import java.nio.ByteBuffer; import java.nio.charset.Charset; import java.nio.charset.StandardCharsets; @@ -10,6 +11,7 @@ * *

Adapted from URLEncodingUtils.java from Apache's HttpClient library. */ +@InternalApi public class Encoding { /** diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/FormRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/FormRequest.java index fa43efcfc..421fdc192 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/FormRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/FormRequest.java @@ -1,7 +1,9 @@ package com.databricks.sdk.core.http; +import com.databricks.sdk.support.InternalApi; import java.util.*; +@InternalApi public class FormRequest extends Request { public FormRequest(String url, Map form) { this(POST, url, form); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/HttpClient.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/HttpClient.java index 39942640e..f3b984ad8 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/HttpClient.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/HttpClient.java @@ -1,7 +1,9 @@ package com.databricks.sdk.core.http; +import com.databricks.sdk.support.InternalApi; import java.io.IOException; +@InternalApi public interface HttpClient { Response execute(Request in) throws IOException; } diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/Request.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/Request.java index e906dfef1..8df193ccd 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/Request.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/Request.java @@ -1,6 +1,7 @@ package com.databricks.sdk.core.http; import com.databricks.sdk.core.DatabricksException; +import com.databricks.sdk.support.InternalApi; import java.io.InputStream; import java.io.UnsupportedEncodingException; import java.net.URI; @@ -8,6 +9,7 @@ import java.nio.charset.StandardCharsets; import java.util.*; +@InternalApi public class Request { public static final String GET = "GET"; public static final String HEAD = "HEAD"; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/RequestOptions.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/RequestOptions.java index a9f6c487c..fb5a0054d 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/RequestOptions.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/RequestOptions.java @@ -1,5 +1,6 @@ package com.databricks.sdk.core.http; +import com.databricks.sdk.support.InternalApi; import java.util.function.Function; /** @@ -8,6 +9,7 @@ * *

Experimental: this class is experimental and subject to change in backward incompatible ways. */ +@InternalApi public class RequestOptions { private Function authenticateFunc; private Function urlFunc; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/Response.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/Response.java index 1c1d51209..02fa74381 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/Response.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/http/Response.java @@ -1,6 +1,7 @@ package com.databricks.sdk.core.http; import com.databricks.sdk.core.DatabricksException; +import com.databricks.sdk.support.InternalApi; import java.io.ByteArrayInputStream; import java.io.InputStream; import java.net.MalformedURLException; @@ -10,6 +11,7 @@ import java.util.List; import java.util.Map; +@InternalApi public class Response { private Request request; private URL url; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AuthParameterPosition.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AuthParameterPosition.java index a8d6b6452..28f3dc07d 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AuthParameterPosition.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AuthParameterPosition.java @@ -1,6 +1,9 @@ package com.databricks.sdk.core.oauth; +import com.databricks.sdk.support.InternalApi; + /** Options for where authentication parameters can be provided in a request. */ +@InternalApi public enum AuthParameterPosition { /** The parameter should be passed as part of the Authorization header. */ HEADER, diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AzureDevOpsIDTokenSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AzureDevOpsIDTokenSource.java index 0e1e747af..7d2f9cd08 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AzureDevOpsIDTokenSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AzureDevOpsIDTokenSource.java @@ -5,6 +5,7 @@ import com.databricks.sdk.core.http.Request; import com.databricks.sdk.core.http.Response; import com.databricks.sdk.core.utils.Environment; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.databind.node.ObjectNode; import com.google.common.base.Strings; @@ -19,6 +20,7 @@ * href="https://learn.microsoft.com/en-us/rest/api/azure/devops/distributedtask/oidctoken/create">Azure * DevOps OIDC token API. */ +@InternalApi public class AzureDevOpsIDTokenSource implements IDTokenSource { /* Access token for authenticating with Azure DevOps API */ private final String azureDevOpsAccessToken; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AzureGithubOidcCredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AzureGithubOidcCredentialsProvider.java index e661903b5..6a5a8c278 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AzureGithubOidcCredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AzureGithubOidcCredentialsProvider.java @@ -3,6 +3,7 @@ import com.databricks.sdk.core.*; import com.databricks.sdk.core.http.Request; import com.databricks.sdk.core.http.Response; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.databind.node.ObjectNode; import java.io.IOException; @@ -14,6 +15,7 @@ * OIDC token for an Azure Active Directory (AAD) Service Principal OAuth token. This class handles * the process of obtaining, refreshing, and attaching the necessary tokens to each HTTP request. */ +@InternalApi public class AzureGithubOidcCredentialsProvider implements CredentialsProvider { private final ObjectMapper mapper = new ObjectMapper(); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AzureServicePrincipalCredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AzureServicePrincipalCredentialsProvider.java index 640244b9d..eca52808d 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AzureServicePrincipalCredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/AzureServicePrincipalCredentialsProvider.java @@ -2,6 +2,7 @@ import com.databricks.sdk.core.*; import com.databricks.sdk.core.utils.AzureUtils; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.databind.ObjectMapper; import java.util.HashMap; import java.util.Map; @@ -12,6 +13,7 @@ * Adds refreshed Azure Active Directory (AAD) Service Principal OAuth tokens to every request, * while automatically resolving different Azure environment endpoints. */ +@InternalApi public class AzureServicePrincipalCredentialsProvider implements CredentialsProvider { private static final Logger logger = LoggerFactory.getLogger(AzureServicePrincipalCredentialsProvider.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/DataPlaneTokenSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/DataPlaneTokenSource.java index 75ffed81a..ad4609cf9 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/DataPlaneTokenSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/DataPlaneTokenSource.java @@ -1,6 +1,7 @@ package com.databricks.sdk.core.oauth; import com.databricks.sdk.core.http.HttpClient; +import com.databricks.sdk.support.InternalApi; import com.google.auto.value.AutoValue; import java.util.Objects; import java.util.concurrent.ConcurrentHashMap; @@ -13,6 +14,7 @@ * {@link EndpointTokenSource} instances are used to efficiently reuse tokens for repeated requests * to the same endpoint with the same authorization context. */ +@InternalApi public class DataPlaneTokenSource { private final HttpClient httpClient; private final TokenSource cpTokenSource; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/EndpointTokenSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/EndpointTokenSource.java index dfd601695..afc40024e 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/EndpointTokenSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/EndpointTokenSource.java @@ -2,6 +2,7 @@ import com.databricks.sdk.core.DatabricksException; import com.databricks.sdk.core.http.HttpClient; +import com.databricks.sdk.support.InternalApi; import java.time.Instant; import java.util.HashMap; import java.util.Map; @@ -13,6 +14,7 @@ * Represents a token source that exchanges a control plane token for an endpoint-specific dataplane * token. It utilizes an underlying {@link TokenSource} to obtain the initial control plane token. */ +@InternalApi public class EndpointTokenSource implements TokenSource { private static final Logger LOG = LoggerFactory.getLogger(EndpointTokenSource.class); private static final String JWT_GRANT_TYPE = "urn:ietf:params:oauth:grant-type:jwt-bearer"; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/EnvVarIDTokenSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/EnvVarIDTokenSource.java index 5bbc1c4e2..699ffeda7 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/EnvVarIDTokenSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/EnvVarIDTokenSource.java @@ -2,9 +2,11 @@ import com.databricks.sdk.core.DatabricksException; import com.databricks.sdk.core.utils.Environment; +import com.databricks.sdk.support.InternalApi; import com.google.common.base.Strings; /** Implementation of {@link IDTokenSource} that reads the ID token from an environment variable. */ +@InternalApi public class EnvVarIDTokenSource implements IDTokenSource { /* The name of the environment variable to read the ID token from. */ private final String envVarName; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/ErrorTokenSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/ErrorTokenSource.java index 0add3d9c6..3ba744fde 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/ErrorTokenSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/ErrorTokenSource.java @@ -1,12 +1,14 @@ package com.databricks.sdk.core.oauth; import com.databricks.sdk.core.DatabricksException; +import com.databricks.sdk.support.InternalApi; import java.util.Objects; /** * A TokenSource implementation that always throws an error when attempting to get a token. This is * used when the header factory is not an OAuthHeaderFactory. */ +@InternalApi public class ErrorTokenSource implements TokenSource { private final String errorMessage; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/ExternalBrowserCredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/ExternalBrowserCredentialsProvider.java index b2625f82d..2050fe5af 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/ExternalBrowserCredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/ExternalBrowserCredentialsProvider.java @@ -3,6 +3,7 @@ import com.databricks.sdk.core.CredentialsProvider; import com.databricks.sdk.core.DatabricksConfig; import com.databricks.sdk.core.DatabricksException; +import com.databricks.sdk.support.InternalApi; import java.io.IOException; import java.nio.file.Path; import java.util.ArrayList; @@ -19,6 +20,7 @@ * browser for the user to authorize the application. Uses a specified TokenCache or creates a * default one if none is provided. */ +@InternalApi public class ExternalBrowserCredentialsProvider implements CredentialsProvider { private static final Logger LOGGER = LoggerFactory.getLogger(ExternalBrowserCredentialsProvider.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/FileIDTokenSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/FileIDTokenSource.java index b503d454c..74d227028 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/FileIDTokenSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/FileIDTokenSource.java @@ -1,6 +1,7 @@ package com.databricks.sdk.core.oauth; import com.databricks.sdk.core.DatabricksException; +import com.databricks.sdk.support.InternalApi; import com.google.common.base.Strings; import java.io.IOException; import java.nio.charset.StandardCharsets; @@ -19,6 +20,7 @@ * * @see IDTokenSource */ +@InternalApi public class FileIDTokenSource implements IDTokenSource { /* The path to the file containing the ID token. */ private final String filePath; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/FileTokenCache.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/FileTokenCache.java index ff62ca835..b1805c131 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/FileTokenCache.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/FileTokenCache.java @@ -1,6 +1,7 @@ package com.databricks.sdk.core.oauth; import com.databricks.sdk.core.utils.SerDeUtils; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.databind.ObjectMapper; import java.io.File; import java.nio.charset.StandardCharsets; @@ -11,6 +12,7 @@ import org.slf4j.LoggerFactory; /** A TokenCache implementation that stores tokens as plain files. */ +@InternalApi public class FileTokenCache implements TokenCache { private static final Logger LOGGER = LoggerFactory.getLogger(FileTokenCache.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/GithubIDTokenSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/GithubIDTokenSource.java index fe5414e9d..0ed9cc604 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/GithubIDTokenSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/GithubIDTokenSource.java @@ -4,6 +4,7 @@ import com.databricks.sdk.core.http.HttpClient; import com.databricks.sdk.core.http.Request; import com.databricks.sdk.core.http.Response; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.databind.node.ObjectNode; import com.google.common.base.Strings; @@ -14,6 +15,7 @@ * IDTokenSource interface and provides a method for obtaining ID tokens specifically from GitHub * Actions environment. */ +@InternalApi public class GithubIDTokenSource implements IDTokenSource { /* URL endpoint for requesting ID tokens from GitHub Actions */ private final String actionsIDTokenRequestURL; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/OAuthM2MServicePrincipalCredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/OAuthM2MServicePrincipalCredentialsProvider.java index bb97f238b..790aacc15 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/OAuthM2MServicePrincipalCredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/OAuthM2MServicePrincipalCredentialsProvider.java @@ -1,12 +1,14 @@ package com.databricks.sdk.core.oauth; import com.databricks.sdk.core.*; +import com.databricks.sdk.support.InternalApi; import java.io.IOException; /** * Adds refreshed Databricks machine-to-machine OAuth Bearer token to every request, if * /oidc/.well-known/oauth-authorization-server is available on the given host. */ +@InternalApi public class OAuthM2MServicePrincipalCredentialsProvider implements CredentialsProvider { @Override diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/OidcTokenSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/OidcTokenSource.java index 901b6bcc4..23eac4330 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/OidcTokenSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/OidcTokenSource.java @@ -4,6 +4,7 @@ import com.databricks.sdk.core.http.FormRequest; import com.databricks.sdk.core.http.HttpClient; import com.databricks.sdk.core.http.Response; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.databind.ObjectMapper; import com.google.common.base.Strings; import com.google.common.collect.ImmutableMap; @@ -15,6 +16,7 @@ * protocol. It communicates with an OAuth server to request access tokens using the client * credentials grant type instead of a client secret. */ +@InternalApi class OidcTokenSource implements TokenSource { private final HttpClient httpClient; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/OpenIDConnectEndpoints.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/OpenIDConnectEndpoints.java index 7babdf70a..0a7c029d2 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/OpenIDConnectEndpoints.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/OpenIDConnectEndpoints.java @@ -1,5 +1,6 @@ package com.databricks.sdk.core.oauth; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; import java.net.MalformedURLException; @@ -9,6 +10,7 @@ * href="https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderConfigurationRequest">the * OIDC spec. */ +@InternalApi @JsonIgnoreProperties(ignoreUnknown = true) public class OpenIDConnectEndpoints { @JsonProperty("token_endpoint") diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/SessionCredentials.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/SessionCredentials.java index 165b504f0..34a1878d1 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/SessionCredentials.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/SessionCredentials.java @@ -3,6 +3,7 @@ import com.databricks.sdk.core.CredentialsProvider; import com.databricks.sdk.core.DatabricksConfig; import com.databricks.sdk.core.http.HttpClient; +import com.databricks.sdk.support.InternalApi; import java.io.Serializable; import java.util.Optional; import org.slf4j.Logger; @@ -15,6 +16,7 @@ * requests to an API, and a long-lived refresh token, which can be used to fetch new access tokens. * Calling refresh() uses the refresh token to retrieve a new access token to authenticate to APIs. */ +@InternalApi public class SessionCredentials implements CredentialsProvider, Serializable { private static final long serialVersionUID = 3083941540130596650L; private static final Logger LOGGER = LoggerFactory.getLogger(SessionCredentials.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/SessionCredentialsTokenSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/SessionCredentialsTokenSource.java index d1552f35a..3c42e0490 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/SessionCredentialsTokenSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/SessionCredentialsTokenSource.java @@ -2,6 +2,7 @@ import com.databricks.sdk.core.DatabricksException; import com.databricks.sdk.core.http.HttpClient; +import com.databricks.sdk.support.InternalApi; import java.util.HashMap; import java.util.Map; import java.util.Optional; @@ -13,6 +14,7 @@ * *

Implements the refresh_token OAuth grant type with optional token caching. */ +@InternalApi public class SessionCredentialsTokenSource implements TokenSource { private static final Logger LOGGER = LoggerFactory.getLogger(SessionCredentialsTokenSource.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/TokenCacheUtils.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/TokenCacheUtils.java index aaaeca4c8..fa7ff8706 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/TokenCacheUtils.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/TokenCacheUtils.java @@ -1,5 +1,6 @@ package com.databricks.sdk.core.oauth; +import com.databricks.sdk.support.InternalApi; import java.nio.charset.StandardCharsets; import java.nio.file.Path; import java.nio.file.Paths; @@ -8,6 +9,7 @@ import java.util.List; /** Utility methods for TokenCache implementations. */ +@InternalApi public class TokenCacheUtils { // Base path for token cache files private static final String BASE_PATH = ".config/databricks-sdk-java/oauth"; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/TokenEndpointClient.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/TokenEndpointClient.java index 3e8b13a4d..8931ec162 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/TokenEndpointClient.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/oauth/TokenEndpointClient.java @@ -6,6 +6,7 @@ import com.databricks.sdk.core.http.HttpClient; import com.databricks.sdk.core.http.Request; import com.databricks.sdk.core.http.Response; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.databind.ObjectMapper; import java.io.IOException; import java.time.Instant; @@ -23,6 +24,7 @@ * using the provided HTTP client and request parameters. It handles the HTTP request and parses the * JSON response into an {@link OAuthResponse} object. */ +@InternalApi public final class TokenEndpointClient { private static final Logger LOG = LoggerFactory.getLogger(TokenEndpointClient.class); private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper(); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/retry/RequestBasedRetryStrategyPicker.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/retry/RequestBasedRetryStrategyPicker.java index 906445ba3..4964f47db 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/retry/RequestBasedRetryStrategyPicker.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/retry/RequestBasedRetryStrategyPicker.java @@ -1,6 +1,7 @@ package com.databricks.sdk.core.retry; import com.databricks.sdk.core.http.Request; +import com.databricks.sdk.support.InternalApi; import java.util.AbstractMap; import java.util.Arrays; import java.util.List; @@ -12,6 +13,7 @@ * A RetryStrategyPicker that selects a retry strategy based on whether the request is idempotent or * not. */ +@InternalApi public class RequestBasedRetryStrategyPicker implements RetryStrategyPicker { private static final List IDEMPOTENT_REQUESTS = Arrays.asList( diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/retry/RetryUtils.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/retry/RetryUtils.java index ce7358a9e..bc710b831 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/retry/RetryUtils.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/retry/RetryUtils.java @@ -1,9 +1,11 @@ package com.databricks.sdk.core.retry; import com.databricks.sdk.core.DatabricksError; +import com.databricks.sdk.support.InternalApi; import java.util.Arrays; import java.util.List; +@InternalApi public class RetryUtils { private static final List TRANSIENT_ERROR_STRING_MATCHES = Arrays.asList( diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/AzureUtils.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/AzureUtils.java index c5b0aaaa0..2b054d8c7 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/AzureUtils.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/AzureUtils.java @@ -6,6 +6,7 @@ import com.databricks.sdk.core.http.Response; import com.databricks.sdk.core.oauth.*; import com.databricks.sdk.service.provisioning.Workspace; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.databind.node.ObjectNode; @@ -15,6 +16,7 @@ import java.util.Optional; import java.util.function.BiFunction; +@InternalApi public class AzureUtils { /** Azure authentication endpoint for tenant ID discovery */ diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/ClockSupplier.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/ClockSupplier.java index 26a8bf78c..71d4530cf 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/ClockSupplier.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/ClockSupplier.java @@ -1,7 +1,9 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; import java.time.Clock; +@InternalApi public interface ClockSupplier { Clock getClock(); } diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/Cloud.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/Cloud.java index d4c2558c5..afb327440 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/Cloud.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/Cloud.java @@ -1,5 +1,8 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; + +@InternalApi public enum Cloud { AWS, AZURE, diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/CustomCloseInputStream.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/CustomCloseInputStream.java index 486ccab88..73ee6fde9 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/CustomCloseInputStream.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/CustomCloseInputStream.java @@ -1,8 +1,10 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; import java.io.IOException; import java.io.InputStream; +@InternalApi public class CustomCloseInputStream extends InputStream { private final InputStream inputStream; private final Runnable cleanup; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/CustomRoutePlanner.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/CustomRoutePlanner.java index f5a63c5a9..595860ce3 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/CustomRoutePlanner.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/CustomRoutePlanner.java @@ -1,5 +1,6 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; import java.util.ArrayList; import java.util.Arrays; import java.util.List; @@ -17,6 +18,7 @@ * Custom route planner that routes requests via a proxy, except for hosts that match a list of * non-proxy hosts. */ +@InternalApi public class CustomRoutePlanner implements HttpRoutePlanner { private final DefaultProxyRoutePlanner defaultRoutePlanner; private final List nonProxyHostRegex; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/Environment.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/Environment.java index ce08f1dc4..6d3e0a4c9 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/Environment.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/Environment.java @@ -1,9 +1,11 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; import java.util.Arrays; import java.util.List; import java.util.Map; +@InternalApi public class Environment { private final Map env; private final List path; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/GoogleUtils.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/GoogleUtils.java index 42358d4d4..c2a6d3cc5 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/GoogleUtils.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/GoogleUtils.java @@ -1,8 +1,10 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; import java.util.Arrays; import java.util.List; +@InternalApi public class GoogleUtils { public static List GCP_SCOPES = Arrays.asList( diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/LinuxUtilities.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/LinuxUtilities.java index 171721966..2f28ed01d 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/LinuxUtilities.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/LinuxUtilities.java @@ -1,9 +1,11 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; import java.util.Arrays; import java.util.List; /** Linux specific utilities. */ +@InternalApi public class LinuxUtilities implements OSUtilities { private final Environment env; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/MacOSUtilities.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/MacOSUtilities.java index 3efbbf509..915e7f433 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/MacOSUtilities.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/MacOSUtilities.java @@ -1,9 +1,11 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; import java.util.Arrays; import java.util.List; /** MacOS specific utilities. */ +@InternalApi public class MacOSUtilities implements OSUtilities { private final Environment env; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/OSUtilities.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/OSUtilities.java index 4b7b8fa3a..adf68a6f0 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/OSUtilities.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/OSUtilities.java @@ -1,8 +1,10 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; import java.util.List; /** OS-specific functionality needed by the SDK. */ +@InternalApi public interface OSUtilities { /** * Returns a list of strings representing an executable command for the current operating system, diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/OSUtils.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/OSUtils.java index 934335c29..66da25cfa 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/OSUtils.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/OSUtils.java @@ -1,6 +1,7 @@ package com.databricks.sdk.core.utils; import com.databricks.sdk.core.DatabricksException; +import com.databricks.sdk.support.InternalApi; import java.io.IOException; import java.nio.file.Files; import java.nio.file.Path; @@ -13,6 +14,7 @@ * OSUtils is an interface that provides utility methods for determining the current operating * system and returning executable command based on the operating system. */ +@InternalApi public class OSUtils { private static final Logger LOG = LoggerFactory.getLogger(OSUtils.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/ProtobufModule.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/ProtobufModule.java index c28e095e5..11cb2df9b 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/ProtobufModule.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/ProtobufModule.java @@ -1,5 +1,6 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.core.JsonGenerator; import com.fasterxml.jackson.core.JsonParser; import com.fasterxml.jackson.databind.DeserializationContext; @@ -15,6 +16,7 @@ import java.io.IOException; /** Jackson module for serializing and deserializing Google Protocol Buffers types. */ +@InternalApi public class ProtobufModule extends SimpleModule { public ProtobufModule() { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/ProxyUtils.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/ProxyUtils.java index b02a38d39..3bea4e78f 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/ProxyUtils.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/ProxyUtils.java @@ -2,6 +2,7 @@ import com.databricks.sdk.core.DatabricksException; import com.databricks.sdk.core.ProxyConfig; +import com.databricks.sdk.support.InternalApi; import java.security.Principal; import org.apache.http.HttpHost; import org.apache.http.auth.AuthSchemeProvider; @@ -20,6 +21,7 @@ * This class is used to setup the proxy configs for the http client. This includes setting up the * proxy host, port, and authentication. */ +@InternalApi public class ProxyUtils { /** diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/SerDeUtils.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/SerDeUtils.java index ce1a84a2c..d7c204b0b 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/SerDeUtils.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/SerDeUtils.java @@ -1,5 +1,6 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.databind.DeserializationFeature; import com.fasterxml.jackson.databind.ObjectMapper; @@ -8,6 +9,7 @@ import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule; /** Utilities for serialization and deserialization in the Databricks Java SDK. */ +@InternalApi public class SerDeUtils { public static ObjectMapper createMapper() { ObjectMapper mapper = new ObjectMapper(); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/SystemTimer.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/SystemTimer.java index 728df59e4..d26d2051a 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/SystemTimer.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/SystemTimer.java @@ -1,5 +1,8 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; + +@InternalApi public class SystemTimer implements Timer { @Override public void sleep(long milliseconds) throws InterruptedException { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/Timer.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/Timer.java index 7e95872fa..b9e7ca8ec 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/Timer.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/Timer.java @@ -1,5 +1,8 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; + +@InternalApi public interface Timer { void sleep(long milliseconds) throws InterruptedException; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/UtcClockSupplier.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/UtcClockSupplier.java index 73e6d2bc4..64f5ddd87 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/UtcClockSupplier.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/UtcClockSupplier.java @@ -1,7 +1,9 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; import java.time.Clock; +@InternalApi public class UtcClockSupplier implements ClockSupplier { @Override public Clock getClock() { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/WindowsUtilities.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/WindowsUtilities.java index 150561ddc..5cef7a11f 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/WindowsUtilities.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/utils/WindowsUtilities.java @@ -1,9 +1,11 @@ package com.databricks.sdk.core.utils; +import com.databricks.sdk.support.InternalApi; import java.util.Arrays; import java.util.List; /** Windows specific utilities. */ +@InternalApi public class WindowsUtilities implements OSUtilities { private final Environment env; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/InternalApi.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/InternalApi.java new file mode 100644 index 000000000..3c1d75680 --- /dev/null +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/InternalApi.java @@ -0,0 +1,15 @@ +package com.databricks.sdk.support; + +import java.lang.annotation.*; + +/** + * Indicates that the annotated element is part of the internal implementation and should not be + * used by SDK consumers. + * + *

Elements marked with this annotation are subject to change or removal without notice in any + * release, including minor and patch versions. + */ +@Documented +@Retention(RetentionPolicy.RUNTIME) +@Target({ElementType.TYPE, ElementType.METHOD, ElementType.CONSTRUCTOR, ElementType.PACKAGE}) +public @interface InternalApi {}