From 5fb90c1eec1167fc7330a5c763f7d15e73049c37 Mon Sep 17 00:00:00 2001 From: Serge Smertin Date: Fri, 5 May 2023 15:34:59 +0200 Subject: [PATCH] Add `@DeveloperApi` annotation --- .../com/databricks/sdk/client/ApiClient.java | 2 ++ .../sdk/client/AzureEnvironment.java | 3 +++ .../com/databricks/sdk/client/BodyLogger.java | 2 ++ .../databricks/sdk/client/CliTokenSource.java | 4 +++- .../sdk/client/ConfigAttribute.java | 3 +++ .../sdk/client/ConfigAttributeAccessor.java | 3 +++ .../databricks/sdk/client/ConfigLoader.java | 2 ++ .../sdk/client/CredentialsProvider.java | 3 +++ .../databricks/sdk/client/HeaderFactory.java | 3 +++ .../sdk/client/SimpleHttpServer.java | 2 ++ .../sdk/client/error/ApiErrorBody.java | 2 ++ .../sdk/client/error/ApiErrors.java | 2 ++ .../sdk/client/error/CheckForRetryResult.java | 2 ++ .../sdk/client/http/FormRequest.java | 2 ++ .../sdk/client/http/HttpClient.java | 2 ++ .../databricks/sdk/client/http/Request.java | 2 ++ .../databricks/sdk/client/http/Response.java | 2 ++ .../client/oauth/RefreshableTokenSource.java | 2 ++ .../databricks/sdk/client/oauth/Token.java | 2 ++ .../sdk/client/oauth/TokenSource.java | 3 +++ .../sdk/client/utils/AzureUtils.java | 2 ++ .../databricks/sdk/client/utils/OSUtils.java | 2 ++ .../sdk/client/utils/RealTimer.java | 3 +++ .../databricks/sdk/client/utils/Timer.java | 3 +++ .../java/com/databricks/sdk/mixin/SemVer.java | 3 +++ .../com/databricks/sdk/support/Dedupe.java | 1 + .../databricks/sdk/support/DeveloperApi.java | 21 +++++++++++++++++++ .../com/databricks/sdk/support/Generated.java | 1 + .../com/databricks/sdk/support/Paginator.java | 1 + .../databricks/sdk/support/QueryParam.java | 1 + .../databricks/sdk/support/ToStringer.java | 1 + .../java/com/databricks/sdk/support/Wait.java | 1 + .../databricks/sdk/support/WaitStarter.java | 1 + 33 files changed, 88 insertions(+), 1 deletion(-) create mode 100644 databricks-sdk-java/src/main/java/com/databricks/sdk/support/DeveloperApi.java diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ApiClient.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ApiClient.java index ef3958d54..99eef24bd 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ApiClient.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ApiClient.java @@ -7,6 +7,7 @@ import com.databricks.sdk.client.http.Response; import com.databricks.sdk.client.utils.RealTimer; import com.databricks.sdk.client.utils.Timer; +import com.databricks.sdk.support.DeveloperApi; import com.databricks.sdk.support.QueryParam; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.core.JsonProcessingException; @@ -23,6 +24,7 @@ * Simplified REST API client with retries, JSON POJO SerDe through Jackson and exception POJO * guessing */ +@DeveloperApi public class ApiClient { private static final Logger LOG = LoggerFactory.getLogger(ApiClient.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/AzureEnvironment.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/AzureEnvironment.java index 92adda578..554561bb7 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/AzureEnvironment.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/AzureEnvironment.java @@ -1,5 +1,7 @@ package com.databricks.sdk.client; +import com.databricks.sdk.support.DeveloperApi; + import java.util.HashMap; import java.util.Map; @@ -10,6 +12,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. */ +@DeveloperApi public class AzureEnvironment { private String name; private String serviceManagementEndpoint; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/BodyLogger.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/BodyLogger.java index c21b6bbf7..49ebaaf53 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/BodyLogger.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/BodyLogger.java @@ -1,5 +1,6 @@ package com.databricks.sdk.client; +import com.databricks.sdk.support.DeveloperApi; 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.*; +@DeveloperApi class BodyLogger { private final Set redactKeys = new HashSet() { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/CliTokenSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/CliTokenSource.java index 8c583841c..44389274d 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/CliTokenSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/CliTokenSource.java @@ -3,6 +3,7 @@ import com.databricks.sdk.client.oauth.RefreshableTokenSource; import com.databricks.sdk.client.oauth.Token; import com.databricks.sdk.client.utils.OSUtils; +import com.databricks.sdk.support.DeveloperApi; import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.ObjectMapper; import java.io.IOException; @@ -16,7 +17,8 @@ import java.util.function.Supplier; import org.apache.commons.io.IOUtils; -public class CliTokenSource extends RefreshableTokenSource implements OSUtils { +@DeveloperApi +class CliTokenSource extends RefreshableTokenSource implements OSUtils { private List cmd; private String tokenTypeField; private String accessTokenField; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ConfigAttribute.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ConfigAttribute.java index b9f575cca..1ed1dc32d 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ConfigAttribute.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ConfigAttribute.java @@ -1,10 +1,13 @@ package com.databricks.sdk.client; +import com.databricks.sdk.support.DeveloperApi; + import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; +@DeveloperApi @Target({ElementType.FIELD}) @Retention(RetentionPolicy.RUNTIME) public @interface ConfigAttribute { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ConfigAttributeAccessor.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ConfigAttributeAccessor.java index bdf75d0b2..64b5b8a0e 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ConfigAttributeAccessor.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ConfigAttributeAccessor.java @@ -1,9 +1,12 @@ package com.databricks.sdk.client; +import com.databricks.sdk.support.DeveloperApi; + import java.lang.reflect.Field; import java.util.Map; import java.util.Objects; +@DeveloperApi class ConfigAttributeAccessor { private ConfigAttribute configAttribute; private Field field; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ConfigLoader.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ConfigLoader.java index 4101ef588..1dded5c13 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ConfigLoader.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/ConfigLoader.java @@ -1,5 +1,6 @@ package com.databricks.sdk.client; +import com.databricks.sdk.support.DeveloperApi; import java.io.File; import java.io.FileNotFoundException; import java.io.IOException; @@ -12,6 +13,7 @@ import org.slf4j.Logger; import org.slf4j.LoggerFactory; +@DeveloperApi public class ConfigLoader { private static final Logger LOG = LoggerFactory.getLogger(ConfigLoader.class); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/CredentialsProvider.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/CredentialsProvider.java index 1d8a553bf..5ff8d7940 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/CredentialsProvider.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/CredentialsProvider.java @@ -1,5 +1,8 @@ package com.databricks.sdk.client; +import com.databricks.sdk.support.DeveloperApi; + +@DeveloperApi public interface CredentialsProvider { String authType(); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/HeaderFactory.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/HeaderFactory.java index ab7b0eb31..978e45f95 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/HeaderFactory.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/HeaderFactory.java @@ -1,7 +1,10 @@ package com.databricks.sdk.client; +import com.databricks.sdk.support.DeveloperApi; + import java.util.Map; +@DeveloperApi public interface HeaderFactory { /** * Part of the Unified Client Authentication framework. diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/SimpleHttpServer.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/SimpleHttpServer.java index de40b33aa..efadf04bf 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/SimpleHttpServer.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/SimpleHttpServer.java @@ -1,5 +1,6 @@ package com.databricks.sdk.client; +import com.databricks.sdk.support.DeveloperApi; import java.io.*; import java.net.ServerSocket; import java.net.Socket; @@ -13,6 +14,7 @@ * Simplistic and short-lived HTTP server intended to handle one or two requests before shutting * down. Not intended to serve traffic to the Internet. */ +@DeveloperApi class SimpleHttpServer implements Runnable { private final ServerSocket server; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/error/ApiErrorBody.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/error/ApiErrorBody.java index 2dd8ee71b..89a9022dd 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/error/ApiErrorBody.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/error/ApiErrorBody.java @@ -1,5 +1,6 @@ package com.databricks.sdk.client.error; +import com.databricks.sdk.support.DeveloperApi; import com.fasterxml.jackson.annotation.JsonProperty; /** @@ -9,6 +10,7 @@ * href="https://github.com/databricks/databricks-sdk-go/blob/main/apierr/errors.go#L31">the * APIErrorBody struct from the Go SDK. */ +@DeveloperApi public class ApiErrorBody { private String errorCode; private String message; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/error/ApiErrors.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/error/ApiErrors.java index 70f696ecd..50a1c87c6 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/error/ApiErrors.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/error/ApiErrors.java @@ -1,12 +1,14 @@ package com.databricks.sdk.client.error; import com.databricks.sdk.client.http.Response; +import com.databricks.sdk.support.DeveloperApi; import com.fasterxml.jackson.databind.ObjectMapper; import java.io.IOException; import java.util.regex.Matcher; import java.util.regex.Pattern; /** Helper methods for inspecting the response and errors thrown during API requests. */ +@DeveloperApi 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/client/error/CheckForRetryResult.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/error/CheckForRetryResult.java index 272cf7f2d..9b696dccf 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/error/CheckForRetryResult.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/error/CheckForRetryResult.java @@ -1,6 +1,7 @@ package com.databricks.sdk.client.error; import com.databricks.sdk.client.DatabricksException; +import com.databricks.sdk.support.DeveloperApi; import java.net.ConnectException; import java.net.SocketException; import java.net.SocketTimeoutException; @@ -17,6 +18,7 @@ * should be parsed and returned to the user. If error is not null, the request has failed in an * unrecoverable way and this exception should be thrown, potentially wrapped in another exception. */ +@DeveloperApi public class CheckForRetryResult { private final Logger LOG = LoggerFactory.getLogger(getClass().getName()); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/FormRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/FormRequest.java index 7a6827cca..b93306e69 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/FormRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/FormRequest.java @@ -1,7 +1,9 @@ package com.databricks.sdk.client.http; +import com.databricks.sdk.support.DeveloperApi; import java.util.Map; +@DeveloperApi 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/client/http/HttpClient.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/HttpClient.java index 8b6a4ce5c..bdea7d0f8 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/HttpClient.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/HttpClient.java @@ -1,7 +1,9 @@ package com.databricks.sdk.client.http; +import com.databricks.sdk.support.DeveloperApi; import java.io.IOException; +@DeveloperApi public interface HttpClient { Response execute(Request in) throws IOException; } diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/Request.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/Request.java index 535619a24..ce68c3c47 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/Request.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/Request.java @@ -1,12 +1,14 @@ package com.databricks.sdk.client.http; import com.databricks.sdk.client.DatabricksException; +import com.databricks.sdk.support.DeveloperApi; import java.io.UnsupportedEncodingException; import java.net.URI; import java.net.URLEncoder; import java.nio.charset.StandardCharsets; import java.util.*; +@DeveloperApi public class Request { public static final String GET = "GET"; public static final String DELETE = "DELETE"; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/Response.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/Response.java index 6b9838ac5..d28f1dc04 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/Response.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/http/Response.java @@ -1,9 +1,11 @@ package com.databricks.sdk.client.http; +import com.databricks.sdk.support.DeveloperApi; import java.util.Collections; import java.util.List; import java.util.Map; +@DeveloperApi public class Response { private Request request; private int statusCode; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/oauth/RefreshableTokenSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/oauth/RefreshableTokenSource.java index 09f86b058..1d94d0c8b 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/oauth/RefreshableTokenSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/oauth/RefreshableTokenSource.java @@ -4,6 +4,7 @@ import com.databricks.sdk.client.http.FormRequest; import com.databricks.sdk.client.http.HttpClient; import com.databricks.sdk.client.http.Response; +import com.databricks.sdk.support.DeveloperApi; import com.fasterxml.jackson.databind.ObjectMapper; import java.io.IOException; import java.time.LocalDateTime; @@ -18,6 +19,7 @@ *

Calls to getToken() will first check if the token is still valid (currently defined by having * at least 10 seconds until expiry). If not, refresh() is called first to refresh the token. */ +@DeveloperApi public abstract class RefreshableTokenSource implements TokenSource { protected Token token; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/oauth/Token.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/oauth/Token.java index 095eaba77..0d415c79f 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/oauth/Token.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/oauth/Token.java @@ -1,10 +1,12 @@ package com.databricks.sdk.client.oauth; +import com.databricks.sdk.support.DeveloperApi; import com.fasterxml.jackson.annotation.JsonProperty; import java.time.LocalDateTime; import java.time.temporal.ChronoUnit; import java.util.Objects; +@DeveloperApi public class Token { @JsonProperty private String accessToken; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/oauth/TokenSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/oauth/TokenSource.java index 1bef64367..5f7c4be76 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/oauth/TokenSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/oauth/TokenSource.java @@ -1,6 +1,9 @@ package com.databricks.sdk.client.oauth; +import com.databricks.sdk.support.DeveloperApi; + /** A resource which can produce an OAuth token. */ +@DeveloperApi public interface TokenSource { Token getToken(); } diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/AzureUtils.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/AzureUtils.java index df48dcf1e..68a789012 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/AzureUtils.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/AzureUtils.java @@ -8,6 +8,7 @@ import com.databricks.sdk.client.oauth.ClientCredentials; import com.databricks.sdk.client.oauth.RefreshableTokenSource; import com.databricks.sdk.client.oauth.Token; +import com.databricks.sdk.support.DeveloperApi; 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.HashMap; import java.util.Map; +@DeveloperApi public interface AzureUtils { /** diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/OSUtils.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/OSUtils.java index 0e56075ac..befc39aba 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/OSUtils.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/OSUtils.java @@ -1,5 +1,6 @@ package com.databricks.sdk.client.utils; +import com.databricks.sdk.support.DeveloperApi; import java.util.Arrays; import java.util.List; @@ -7,6 +8,7 @@ * OSUtils is an interface that provides utility methods for determining the current operating * system and returning executable command based on the operating system. */ +@DeveloperApi public interface OSUtils { /** diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/RealTimer.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/RealTimer.java index 70c21023b..5bc1550b8 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/RealTimer.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/RealTimer.java @@ -1,5 +1,8 @@ package com.databricks.sdk.client.utils; +import com.databricks.sdk.support.DeveloperApi; + +@DeveloperApi public class RealTimer implements Timer { @Override public void wait(int milliseconds) throws InterruptedException { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/Timer.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/Timer.java index b719695c0..228c3f954 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/Timer.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/client/utils/Timer.java @@ -1,5 +1,8 @@ package com.databricks.sdk.client.utils; +import com.databricks.sdk.support.DeveloperApi; + +@DeveloperApi public interface Timer { void wait(int milliseconds) throws InterruptedException; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/mixin/SemVer.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/mixin/SemVer.java index f82fd62ee..5d88722ba 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/mixin/SemVer.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/mixin/SemVer.java @@ -1,8 +1,11 @@ package com.databricks.sdk.mixin; +import com.databricks.sdk.support.DeveloperApi; + import java.util.regex.Matcher; import java.util.regex.Pattern; +@DeveloperApi public class SemVer implements Comparable { public final int major; public final int minor; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Dedupe.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Dedupe.java index 262a6af15..540d189ee 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Dedupe.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Dedupe.java @@ -14,6 +14,7 @@ * @param item of iteration * @param identifier */ +@DeveloperApi class Dedupe implements Iterator { private final Iterator inner; private final Function idGetter; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/DeveloperApi.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/DeveloperApi.java new file mode 100644 index 000000000..0c1acb5a6 --- /dev/null +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/DeveloperApi.java @@ -0,0 +1,21 @@ +package com.databricks.sdk.support; + +import java.lang.annotation.*; + +/** + * Lower-level and unstable API intended for Databricks developers. + * + *

Elements annotated with `@DeveloperApi` might change or be removed in minor versions of this + * SDK. + */ +@Retention(RetentionPolicy.RUNTIME) +@Target({ + ElementType.TYPE, + ElementType.FIELD, + ElementType.METHOD, + ElementType.PARAMETER, + ElementType.CONSTRUCTOR, + ElementType.LOCAL_VARIABLE, + ElementType.PACKAGE +}) +public @interface DeveloperApi {} diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Generated.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Generated.java index a566dbfcc..3c1783fcb 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Generated.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Generated.java @@ -8,6 +8,7 @@ *

This annotation is used to exclude the class or method from code coverage. */ @Documented +@DeveloperApi @Retention(RetentionPolicy.RUNTIME) @Target({ElementType.TYPE, ElementType.METHOD, ElementType.CONSTRUCTOR}) public @interface Generated {} diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Paginator.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Paginator.java index 1e08692fb..d2c7766c4 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Paginator.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Paginator.java @@ -11,6 +11,7 @@ * @param response type * @param item type */ +@DeveloperApi public class Paginator implements Iterable { private final Function requestFn; private final Function> itemsFn; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/QueryParam.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/QueryParam.java index 544858bbd..8694277db 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/QueryParam.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/QueryParam.java @@ -5,6 +5,7 @@ import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; +@DeveloperApi @Target({ElementType.FIELD}) @Retention(RetentionPolicy.RUNTIME) public @interface QueryParam { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/ToStringer.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/ToStringer.java index 9cc817629..5e84e68b3 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/ToStringer.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/ToStringer.java @@ -2,6 +2,7 @@ import java.util.StringJoiner; +@DeveloperApi public class ToStringer { private final StringJoiner joiner; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Wait.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Wait.java index b4e5bd724..78dfa86d7 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Wait.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/Wait.java @@ -4,6 +4,7 @@ import java.util.concurrent.TimeoutException; import java.util.function.Consumer; +@DeveloperApi public class Wait { private final WaitStarter impl; private final R response; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/WaitStarter.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/WaitStarter.java index 6638b22df..5bc56da9d 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/support/WaitStarter.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/support/WaitStarter.java @@ -4,6 +4,7 @@ import java.util.concurrent.TimeoutException; import java.util.function.Consumer; +@DeveloperApi @FunctionalInterface public interface WaitStarter { T apply(Duration timeout, Consumer progress) throws TimeoutException;