com.oracle.bmc.mysql.ReplicasClient Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of oci-java-sdk-mysql Show documentation
Show all versions of oci-java-sdk-mysql Show documentation
This project contains the SDK used for Oracle Cloud Infrastructure Mysql
/**
* 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.mysql;
import com.oracle.bmc.util.internal.Validate;
import com.oracle.bmc.mysql.requests.*;
import com.oracle.bmc.mysql.responses.*;
import com.oracle.bmc.circuitbreaker.CircuitBreakerConfiguration;
import com.oracle.bmc.util.CircuitBreakerUtils;
import java.util.Objects;
@jakarta.annotation.Generated(value = "OracleSDKGenerator", comments = "API Version: 20190415")
public class ReplicasClient extends com.oracle.bmc.http.internal.BaseSyncClient
implements Replicas {
/** Service instance for Replicas. */
public static final com.oracle.bmc.Service SERVICE =
com.oracle.bmc.Services.serviceBuilder()
.serviceName("REPLICAS")
.serviceEndpointPrefix("")
.serviceEndpointTemplate("https://mysql.{region}.ocp.{secondLevelDomain}")
.build();
private static final org.slf4j.Logger LOG =
org.slf4j.LoggerFactory.getLogger(ReplicasClient.class);
private final ReplicasWaiters waiters;
private final ReplicasPaginators paginators;
ReplicasClient(
com.oracle.bmc.common.ClientBuilderBase builder,
com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
java.util.concurrent.ExecutorService executorService) {
super(
builder,
authenticationDetailsProvider,
CircuitBreakerUtils.DEFAULT_CIRCUIT_BREAKER_CONFIGURATION);
if (executorService == null) {
// up to 50 (core) threads, time out after 60s idle, all daemon
java.util.concurrent.ThreadPoolExecutor threadPoolExecutor =
new java.util.concurrent.ThreadPoolExecutor(
50,
50,
60L,
java.util.concurrent.TimeUnit.SECONDS,
new java.util.concurrent.LinkedBlockingQueue(),
com.oracle.bmc.internal.ClientThreadFactory.builder()
.isDaemon(true)
.nameFormat("Replicas-waiters-%d")
.build());
threadPoolExecutor.allowCoreThreadTimeOut(true);
executorService = threadPoolExecutor;
}
this.waiters = new ReplicasWaiters(executorService, this);
this.paginators = new ReplicasPaginators(this);
}
/**
* 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 java.util.concurrent.ExecutorService executorService;
private Builder(com.oracle.bmc.Service service) {
super(service);
final String packageName = "mysql";
com.oracle.bmc.internal.Alloy.throwDisabledServiceExceptionIfAppropriate(packageName);
requestSignerFactory =
new com.oracle.bmc.http.signing.internal.DefaultRequestSignerFactory(
com.oracle.bmc.http.signing.SigningStrategy.STANDARD);
}
/**
* Set the ExecutorService for the client to be created.
*
* @param executorService executorService
* @return this builder
*/
public Builder executorService(java.util.concurrent.ExecutorService executorService) {
this.executorService = executorService;
return this;
}
/**
* Build the client.
*
* @param authenticationDetailsProvider authentication details provider
* @return the client
*/
public ReplicasClient build(
@jakarta.annotation.Nonnull
com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider
authenticationDetailsProvider) {
return new ReplicasClient(this, authenticationDetailsProvider, executorService);
}
}
@Override
public void setRegion(com.oracle.bmc.Region region) {
super.setRegion(region);
}
@Override
public void setRegion(String regionId) {
super.setRegion(regionId);
}
@Override
public CreateReplicaResponse createReplica(CreateReplicaRequest request) {
Objects.requireNonNull(
request.getCreateReplicaDetails(), "createReplicaDetails is required");
return clientCall(request, CreateReplicaResponse::builder)
.logger(LOG, "createReplica")
.serviceDetails("Replicas", "CreateReplica", "")
.method(com.oracle.bmc.http.client.Method.POST)
.requestBuilder(CreateReplicaRequest::builder)
.basePath("/20190415")
.appendPathParam("replicas")
.accept("application/json")
.appendHeader("opc-request-id", request.getOpcRequestId())
.appendHeader("opc-retry-token", request.getOpcRetryToken())
.operationUsesDefaultRetries()
.hasBody()
.handleBody(
com.oracle.bmc.mysql.model.Replica.class,
CreateReplicaResponse.Builder::replica)
.handleResponseHeaderString("location", CreateReplicaResponse.Builder::location)
.handleResponseHeaderString("etag", CreateReplicaResponse.Builder::etag)
.handleResponseHeaderString(
"opc-request-id", CreateReplicaResponse.Builder::opcRequestId)
.handleResponseHeaderString(
"opc-work-request-id", CreateReplicaResponse.Builder::opcWorkRequestId)
.callSync();
}
@Override
public DeleteReplicaResponse deleteReplica(DeleteReplicaRequest request) {
Validate.notBlank(request.getReplicaId(), "replicaId must not be blank");
return clientCall(request, DeleteReplicaResponse::builder)
.logger(LOG, "deleteReplica")
.serviceDetails(
"Replicas",
"DeleteReplica",
"https://docs.oracle.com/iaas/api/#/en/mysql/20190415/Replica/DeleteReplica")
.method(com.oracle.bmc.http.client.Method.DELETE)
.requestBuilder(DeleteReplicaRequest::builder)
.basePath("/20190415")
.appendPathParam("replicas")
.appendPathParam(request.getReplicaId())
.accept("application/json")
.appendHeader("if-match", request.getIfMatch())
.appendHeader("opc-request-id", request.getOpcRequestId())
.operationUsesDefaultRetries()
.handleResponseHeaderString(
"opc-request-id", DeleteReplicaResponse.Builder::opcRequestId)
.handleResponseHeaderString(
"opc-work-request-id", DeleteReplicaResponse.Builder::opcWorkRequestId)
.callSync();
}
@Override
public GetReplicaResponse getReplica(GetReplicaRequest request) {
Validate.notBlank(request.getReplicaId(), "replicaId must not be blank");
return clientCall(request, GetReplicaResponse::builder)
.logger(LOG, "getReplica")
.serviceDetails(
"Replicas",
"GetReplica",
"https://docs.oracle.com/iaas/api/#/en/mysql/20190415/Replica/GetReplica")
.method(com.oracle.bmc.http.client.Method.GET)
.requestBuilder(GetReplicaRequest::builder)
.basePath("/20190415")
.appendPathParam("replicas")
.appendPathParam(request.getReplicaId())
.accept("application/json")
.appendHeader("opc-request-id", request.getOpcRequestId())
.appendHeader("if-none-match", request.getIfNoneMatch())
.operationUsesDefaultRetries()
.handleBody(
com.oracle.bmc.mysql.model.Replica.class,
GetReplicaResponse.Builder::replica)
.handleResponseHeaderString("etag", GetReplicaResponse.Builder::etag)
.handleResponseHeaderString(
"opc-request-id", GetReplicaResponse.Builder::opcRequestId)
.callSync();
}
@Override
public ListReplicasResponse listReplicas(ListReplicasRequest request) {
Objects.requireNonNull(request.getCompartmentId(), "compartmentId is required");
return clientCall(request, ListReplicasResponse::builder)
.logger(LOG, "listReplicas")
.serviceDetails(
"Replicas",
"ListReplicas",
"https://docs.oracle.com/iaas/api/#/en/mysql/20190415/ReplicaSummary/ListReplicas")
.method(com.oracle.bmc.http.client.Method.GET)
.requestBuilder(ListReplicasRequest::builder)
.basePath("/20190415")
.appendPathParam("replicas")
.appendQueryParam("limit", request.getLimit())
.appendQueryParam("page", request.getPage())
.appendQueryParam("displayName", request.getDisplayName())
.appendQueryParam("dbSystemId", request.getDbSystemId())
.appendQueryParam("compartmentId", request.getCompartmentId())
.appendEnumQueryParam("lifecycleState", request.getLifecycleState())
.appendQueryParam("replicaId", request.getReplicaId())
.appendQueryParam("configurationId", request.getConfigurationId())
.appendQueryParam("isUpToDate", request.getIsUpToDate())
.appendEnumQueryParam("sortBy", request.getSortBy())
.appendEnumQueryParam("sortOrder", request.getSortOrder())
.accept("application/json")
.appendHeader("opc-request-id", request.getOpcRequestId())
.operationUsesDefaultRetries()
.handleBodyList(
com.oracle.bmc.mysql.model.ReplicaSummary.class,
ListReplicasResponse.Builder::items)
.handleResponseHeaderString(
"opc-request-id", ListReplicasResponse.Builder::opcRequestId)
.handleResponseHeaderString(
"opc-next-page", ListReplicasResponse.Builder::opcNextPage)
.callSync();
}
@Override
public UpdateReplicaResponse updateReplica(UpdateReplicaRequest request) {
Validate.notBlank(request.getReplicaId(), "replicaId must not be blank");
Objects.requireNonNull(
request.getUpdateReplicaDetails(), "updateReplicaDetails is required");
return clientCall(request, UpdateReplicaResponse::builder)
.logger(LOG, "updateReplica")
.serviceDetails(
"Replicas",
"UpdateReplica",
"https://docs.oracle.com/iaas/api/#/en/mysql/20190415/Replica/UpdateReplica")
.method(com.oracle.bmc.http.client.Method.PUT)
.requestBuilder(UpdateReplicaRequest::builder)
.basePath("/20190415")
.appendPathParam("replicas")
.appendPathParam(request.getReplicaId())
.accept("application/json")
.appendHeader("if-match", request.getIfMatch())
.appendHeader("opc-request-id", request.getOpcRequestId())
.operationUsesDefaultRetries()
.hasBody()
.handleResponseHeaderString(
"opc-request-id", UpdateReplicaResponse.Builder::opcRequestId)
.handleResponseHeaderString(
"opc-work-request-id", UpdateReplicaResponse.Builder::opcWorkRequestId)
.callSync();
}
@Override
public ReplicasWaiters getWaiters() {
return waiters;
}
@Override
public ReplicasPaginators getPaginators() {
return paginators;
}
/**
* Create a new client instance.
*
* @param authenticationDetailsProvider The authentication details (see {@link Builder#build})
* @deprecated Use the {@link #builder() builder} instead.
*/
@Deprecated
public ReplicasClient(
com.oracle.bmc.auth.BasicAuthenticationDetailsProvider authenticationDetailsProvider) {
this(builder(), authenticationDetailsProvider, null);
}
/**
* 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 ReplicasClient(
com.oracle.bmc.auth.BasicAuthenticationDetailsProvider authenticationDetailsProvider,
com.oracle.bmc.ClientConfiguration configuration) {
this(builder().configuration(configuration), authenticationDetailsProvider, null);
}
/**
* 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 ReplicasClient(
com.oracle.bmc.auth.BasicAuthenticationDetailsProvider authenticationDetailsProvider,
com.oracle.bmc.ClientConfiguration configuration,
com.oracle.bmc.http.ClientConfigurator clientConfigurator) {
this(
builder().configuration(configuration).clientConfigurator(clientConfigurator),
authenticationDetailsProvider,
null);
}
/**
* 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 ReplicasClient(
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,
null);
}
/**
* 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 ReplicasClient(
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,
null);
}
/**
* 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 ReplicasClient(
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,
null);
}
/**
* 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 ReplicasClient(
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,
null);
}
/**
* 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}
* @param executorService {@link Builder#executorService}
* @deprecated Use the {@link #builder() builder} instead.
*/
@Deprecated
public ReplicasClient(
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,
java.util.concurrent.ExecutorService executorService) {
this(
builder()
.configuration(configuration)
.clientConfigurator(clientConfigurator)
.requestSignerFactory(defaultRequestSignerFactory)
.additionalClientConfigurators(additionalClientConfigurators)
.endpoint(endpoint)
.signingStrategyRequestSignerFactories(
signingStrategyRequestSignerFactories),
authenticationDetailsProvider,
executorService);
}
}