All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.oracle.bmc.secrets.SecretsAsyncClient Maven / Gradle / Ivy

/**
 * Copyright (c) 2016, 2024, Oracle and/or its affiliates.  All rights reserved.
 * This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 */
package com.oracle.bmc.secrets;

import com.oracle.bmc.util.internal.Validate;
import com.oracle.bmc.secrets.requests.*;
import com.oracle.bmc.secrets.responses.*;

import java.util.Objects;

/**
 * Async client implementation for Secrets service. 
* There are two ways to use async client: 1. Use AsyncHandler: using AsyncHandler, if the response * to the call is an {@link java.io.InputStream}, like getObject Api in object storage service, * developers need to process the stream in AsyncHandler, and not anywhere else, because the stream * will be closed right after the AsyncHandler is invoked.
* 2. Use Java Future: using Java Future, developers need to close the stream after they are done * with the Java Future.
* Accessing the result should be done in a mutually exclusive manner, either through the Future or * the AsyncHandler, but not both. If the Future is used, the caller should pass in null as the * AsyncHandler. If the AsyncHandler is used, it is still safe to use the Future to determine * whether or not the request was completed via Future.isDone/isCancelled.
* Please refer to * https://github.com/oracle/oci-java-sdk/blob/master/bmc-examples/src/main/java/ResteasyClientWithObjectStorageExample.java */ @jakarta.annotation.Generated(value = "OracleSDKGenerator", comments = "API Version: 20190301") public class SecretsAsyncClient extends com.oracle.bmc.http.internal.BaseAsyncClient implements SecretsAsync { /** Service instance for Secrets. */ public static final com.oracle.bmc.Service SERVICE = com.oracle.bmc.Services.serviceBuilder() .serviceName("SECRETS") .serviceEndpointPrefix("") .serviceEndpointTemplate( "https://secrets.vaults.{region}.oci.{secondLevelDomain}") .build(); private static final org.slf4j.Logger LOG = org.slf4j.LoggerFactory.getLogger(SecretsAsyncClient.class); SecretsAsyncClient( com.oracle.bmc.common.ClientBuilderBase builder, com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider authenticationDetailsProvider) { super(builder, authenticationDetailsProvider); } /** * Create a builder for this client. * * @return builder */ public static Builder builder() { return new Builder(SERVICE); } /** * Builder class for this client. The "authenticationDetailsProvider" is required and must be * passed to the {@link #build(AbstractAuthenticationDetailsProvider)} method. */ public static class Builder extends com.oracle.bmc.common.RegionalClientBuilder { private Builder(com.oracle.bmc.Service service) { super(service); final String packageName = "secrets"; com.oracle.bmc.internal.Alloy.throwDisabledServiceExceptionIfAppropriate(packageName); requestSignerFactory = new com.oracle.bmc.http.signing.internal.DefaultRequestSignerFactory( com.oracle.bmc.http.signing.SigningStrategy.STANDARD); } /** * Build the client. * * @param authenticationDetailsProvider authentication details provider * @return the client */ public SecretsAsyncClient build( @jakarta.annotation.Nonnull com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider authenticationDetailsProvider) { return new SecretsAsyncClient(this, authenticationDetailsProvider); } } @Override public void setRegion(com.oracle.bmc.Region region) { super.setRegion(region); } @Override public void setRegion(String regionId) { super.setRegion(regionId); } @Override public java.util.concurrent.Future getSecretBundle( GetSecretBundleRequest request, final com.oracle.bmc.responses.AsyncHandler< GetSecretBundleRequest, GetSecretBundleResponse> handler) { Validate.notBlank(request.getSecretId(), "secretId must not be blank"); return clientCall(request, GetSecretBundleResponse::builder) .logger(LOG, "getSecretBundle") .serviceDetails( "Secrets", "GetSecretBundle", "https://docs.oracle.com/iaas/api/#/en/secretretrieval/20190301/SecretBundle/GetSecretBundle") .method(com.oracle.bmc.http.client.Method.GET) .requestBuilder(GetSecretBundleRequest::builder) .basePath("/20190301") .appendPathParam("secretbundles") .appendPathParam(request.getSecretId()) .appendQueryParam("versionNumber", request.getVersionNumber()) .appendQueryParam("secretVersionName", request.getSecretVersionName()) .appendEnumQueryParam("stage", request.getStage()) .accept("application/json") .appendHeader("opc-request-id", request.getOpcRequestId()) .handleBody( com.oracle.bmc.secrets.model.SecretBundle.class, GetSecretBundleResponse.Builder::secretBundle) .handleResponseHeaderString("etag", GetSecretBundleResponse.Builder::etag) .handleResponseHeaderString( "opc-request-id", GetSecretBundleResponse.Builder::opcRequestId) .callAsync(handler); } @Override public java.util.concurrent.Future getSecretBundleByName( GetSecretBundleByNameRequest request, final com.oracle.bmc.responses.AsyncHandler< GetSecretBundleByNameRequest, GetSecretBundleByNameResponse> handler) { Objects.requireNonNull(request.getSecretName(), "secretName is required"); Objects.requireNonNull(request.getVaultId(), "vaultId is required"); return clientCall(request, GetSecretBundleByNameResponse::builder) .logger(LOG, "getSecretBundleByName") .serviceDetails( "Secrets", "GetSecretBundleByName", "https://docs.oracle.com/iaas/api/#/en/secretretrieval/20190301/SecretBundle/GetSecretBundleByName") .method(com.oracle.bmc.http.client.Method.POST) .requestBuilder(GetSecretBundleByNameRequest::builder) .basePath("/20190301") .appendPathParam("secretbundles") .appendPathParam("actions") .appendPathParam("getByName") .appendQueryParam("secretName", request.getSecretName()) .appendQueryParam("vaultId", request.getVaultId()) .appendQueryParam("versionNumber", request.getVersionNumber()) .appendQueryParam("secretVersionName", request.getSecretVersionName()) .appendEnumQueryParam("stage", request.getStage()) .accept("application/json") .appendHeader("opc-request-id", request.getOpcRequestId()) .handleBody( com.oracle.bmc.secrets.model.SecretBundle.class, GetSecretBundleByNameResponse.Builder::secretBundle) .handleResponseHeaderString( "opc-request-id", GetSecretBundleByNameResponse.Builder::opcRequestId) .callAsync(handler); } @Override public java.util.concurrent.Future listSecretBundleVersions( ListSecretBundleVersionsRequest request, final com.oracle.bmc.responses.AsyncHandler< ListSecretBundleVersionsRequest, ListSecretBundleVersionsResponse> handler) { Validate.notBlank(request.getSecretId(), "secretId must not be blank"); return clientCall(request, ListSecretBundleVersionsResponse::builder) .logger(LOG, "listSecretBundleVersions") .serviceDetails( "Secrets", "ListSecretBundleVersions", "https://docs.oracle.com/iaas/api/#/en/secretretrieval/20190301/SecretBundleVersionSummary/ListSecretBundleVersions") .method(com.oracle.bmc.http.client.Method.GET) .requestBuilder(ListSecretBundleVersionsRequest::builder) .basePath("/20190301") .appendPathParam("secretbundles") .appendPathParam(request.getSecretId()) .appendPathParam("versions") .appendQueryParam("limit", request.getLimit()) .appendQueryParam("page", request.getPage()) .appendEnumQueryParam("sortBy", request.getSortBy()) .appendEnumQueryParam("sortOrder", request.getSortOrder()) .accept("application/json") .appendHeader("opc-request-id", request.getOpcRequestId()) .handleBodyList( com.oracle.bmc.secrets.model.SecretBundleVersionSummary.class, ListSecretBundleVersionsResponse.Builder::items) .handleResponseHeaderString( "opc-request-id", ListSecretBundleVersionsResponse.Builder::opcRequestId) .handleResponseHeaderString( "opc-next-page", ListSecretBundleVersionsResponse.Builder::opcNextPage) .callAsync(handler); } /** * Create a new client instance. * * @param authenticationDetailsProvider The authentication details (see {@link Builder#build}) * @deprecated Use the {@link #builder() builder} instead. */ @Deprecated public SecretsAsyncClient( com.oracle.bmc.auth.BasicAuthenticationDetailsProvider authenticationDetailsProvider) { this(builder(), authenticationDetailsProvider); } /** * Create a new client instance. * * @param authenticationDetailsProvider The authentication details (see {@link Builder#build}) * @param configuration {@link Builder#configuration} * @deprecated Use the {@link #builder() builder} instead. */ @Deprecated public SecretsAsyncClient( com.oracle.bmc.auth.BasicAuthenticationDetailsProvider authenticationDetailsProvider, com.oracle.bmc.ClientConfiguration configuration) { this(builder().configuration(configuration), authenticationDetailsProvider); } /** * Create a new client instance. * * @param authenticationDetailsProvider The authentication details (see {@link Builder#build}) * @param configuration {@link Builder#configuration} * @param clientConfigurator {@link Builder#clientConfigurator} * @deprecated Use the {@link #builder() builder} instead. */ @Deprecated public SecretsAsyncClient( com.oracle.bmc.auth.BasicAuthenticationDetailsProvider authenticationDetailsProvider, com.oracle.bmc.ClientConfiguration configuration, com.oracle.bmc.http.ClientConfigurator clientConfigurator) { this( builder().configuration(configuration).clientConfigurator(clientConfigurator), authenticationDetailsProvider); } /** * Create a new client instance. * * @param authenticationDetailsProvider The authentication details (see {@link Builder#build}) * @param configuration {@link Builder#configuration} * @param clientConfigurator {@link Builder#clientConfigurator} * @param defaultRequestSignerFactory {@link Builder#requestSignerFactory} * @deprecated Use the {@link #builder() builder} instead. */ @Deprecated public SecretsAsyncClient( com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider authenticationDetailsProvider, com.oracle.bmc.ClientConfiguration configuration, com.oracle.bmc.http.ClientConfigurator clientConfigurator, com.oracle.bmc.http.signing.RequestSignerFactory defaultRequestSignerFactory) { this( builder() .configuration(configuration) .clientConfigurator(clientConfigurator) .requestSignerFactory(defaultRequestSignerFactory), authenticationDetailsProvider); } /** * Create a new client instance. * * @param authenticationDetailsProvider The authentication details (see {@link Builder#build}) * @param configuration {@link Builder#configuration} * @param clientConfigurator {@link Builder#clientConfigurator} * @param defaultRequestSignerFactory {@link Builder#requestSignerFactory} * @param additionalClientConfigurators {@link Builder#additionalClientConfigurators} * @deprecated Use the {@link #builder() builder} instead. */ @Deprecated public SecretsAsyncClient( com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider authenticationDetailsProvider, com.oracle.bmc.ClientConfiguration configuration, com.oracle.bmc.http.ClientConfigurator clientConfigurator, com.oracle.bmc.http.signing.RequestSignerFactory defaultRequestSignerFactory, java.util.List additionalClientConfigurators) { this( builder() .configuration(configuration) .clientConfigurator(clientConfigurator) .requestSignerFactory(defaultRequestSignerFactory) .additionalClientConfigurators(additionalClientConfigurators), authenticationDetailsProvider); } /** * Create a new client instance. * * @param authenticationDetailsProvider The authentication details (see {@link Builder#build}) * @param configuration {@link Builder#configuration} * @param clientConfigurator {@link Builder#clientConfigurator} * @param defaultRequestSignerFactory {@link Builder#requestSignerFactory} * @param additionalClientConfigurators {@link Builder#additionalClientConfigurators} * @param endpoint {@link Builder#endpoint} * @deprecated Use the {@link #builder() builder} instead. */ @Deprecated public SecretsAsyncClient( com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider authenticationDetailsProvider, com.oracle.bmc.ClientConfiguration configuration, com.oracle.bmc.http.ClientConfigurator clientConfigurator, com.oracle.bmc.http.signing.RequestSignerFactory defaultRequestSignerFactory, java.util.List additionalClientConfigurators, String endpoint) { this( builder() .configuration(configuration) .clientConfigurator(clientConfigurator) .requestSignerFactory(defaultRequestSignerFactory) .additionalClientConfigurators(additionalClientConfigurators) .endpoint(endpoint), authenticationDetailsProvider); } /** * Create a new client instance. * * @param authenticationDetailsProvider The authentication details (see {@link Builder#build}) * @param configuration {@link Builder#configuration} * @param clientConfigurator {@link Builder#clientConfigurator} * @param defaultRequestSignerFactory {@link Builder#requestSignerFactory} * @param additionalClientConfigurators {@link Builder#additionalClientConfigurators} * @param endpoint {@link Builder#endpoint} * @param signingStrategyRequestSignerFactories {@link * Builder#signingStrategyRequestSignerFactories} * @deprecated Use the {@link #builder() builder} instead. */ @Deprecated public SecretsAsyncClient( com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider authenticationDetailsProvider, com.oracle.bmc.ClientConfiguration configuration, com.oracle.bmc.http.ClientConfigurator clientConfigurator, com.oracle.bmc.http.signing.RequestSignerFactory defaultRequestSignerFactory, java.util.Map< com.oracle.bmc.http.signing.SigningStrategy, com.oracle.bmc.http.signing.RequestSignerFactory> signingStrategyRequestSignerFactories, java.util.List additionalClientConfigurators, String endpoint) { this( builder() .configuration(configuration) .clientConfigurator(clientConfigurator) .requestSignerFactory(defaultRequestSignerFactory) .additionalClientConfigurators(additionalClientConfigurators) .endpoint(endpoint) .signingStrategyRequestSignerFactories( signingStrategyRequestSignerFactories), authenticationDetailsProvider); } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy