Class NosqlClient
- java.lang.Object
-
- com.oracle.bmc.http.internal.BaseSyncClient
-
- com.oracle.bmc.nosql.NosqlClient
-
- All Implemented Interfaces:
Nosql,AutoCloseable
@Generated(value="OracleSDKGenerator", comments="API Version: 20190828") public class NosqlClient extends BaseSyncClient implements Nosql
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classNosqlClient.BuilderBuilder class for this client.
-
Field Summary
Fields Modifier and Type Field Description StringclientCommonLibraryVersionCompatible SDK version, provided by the codegen.Optional<String>minimumClientCommonLibraryVersionFromClientMinimum compatible SDK version, maybe provided by the codegen.static ServiceSERVICEService instance for Nosql.
-
Constructor Summary
Constructors Constructor Description NosqlClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)Deprecated.Use thebuilderinstead.NosqlClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)Deprecated.Use thebuilderinstead.NosqlClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators, String endpoint)Deprecated.Use thebuilderinstead.NosqlClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint)Deprecated.Use thebuilderinstead.NosqlClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint, ExecutorService executorService)Deprecated.Use thebuilderinstead.NosqlClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)Deprecated.Use thebuilderinstead.NosqlClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)Deprecated.Use thebuilderinstead.NosqlClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)Deprecated.Use thebuilderinstead.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static NosqlClient.Builderbuilder()Create a builder for this client.ChangeTableCompartmentResponsechangeTableCompartment(ChangeTableCompartmentRequest request)Change a table’s compartment.voidclose()CreateIndexResponsecreateIndex(CreateIndexRequest request)Create a new index on the table identified by tableNameOrId.CreateReplicaResponsecreateReplica(CreateReplicaRequest request)Add a replica for this table.CreateTableResponsecreateTable(CreateTableRequest request)Create a new table.DeleteIndexResponsedeleteIndex(DeleteIndexRequest request)Delete an index from the table identified by tableNameOrId.DeleteReplicaResponsedeleteReplica(DeleteReplicaRequest request)Delete the specified replica table in the remote region.DeleteRowResponsedeleteRow(DeleteRowRequest request)Delete a single row from the table, by primary key.DeleteTableResponsedeleteTable(DeleteTableRequest request)Delete a table by tableNameOrId.DeleteWorkRequestResponsedeleteWorkRequest(DeleteWorkRequestRequest request)Cancel a work request operation with the given ID.StringgetClientCommonLibraryVersion()GetConfigurationResponsegetConfiguration(GetConfigurationRequest request)Retrieves the current service-level configuration.protected ClientConfiguratorgetDefaultConfigurator()StringgetEndpoint()GetIndexResponsegetIndex(GetIndexRequest request)Get information about a single index.Optional<String>getMinimumClientCommonLibraryVersionFromClient()NosqlPaginatorsgetPaginators()Gets the pre-configured paginators available for list operations in this service which may return multiple pages of data.GetRowResponsegetRow(GetRowRequest request)Get a single row from the table by primary key.GetTableResponsegetTable(GetTableRequest request)Get table info by identifier.NosqlWaitersgetWaiters()Gets the pre-configured waiters available for resources for this service.GetWorkRequestResponsegetWorkRequest(GetWorkRequestRequest request)Get the status of the work request with the given ID.ListIndexesResponselistIndexes(ListIndexesRequest request)Get a list of indexes on a table.ListTablesResponselistTables(ListTablesRequest request)Get a list of tables in a compartment.ListTableUsageResponselistTableUsage(ListTableUsageRequest request)Get table usage info.ListWorkRequestErrorsResponselistWorkRequestErrors(ListWorkRequestErrorsRequest request)Return a (paginated) list of errors for a given work request.ListWorkRequestLogsResponselistWorkRequestLogs(ListWorkRequestLogsRequest request)Return a (paginated) list of logs for a given work request.ListWorkRequestsResponselistWorkRequests(ListWorkRequestsRequest request)List the work requests in a compartment.voidpopulateServiceParametersInEndpoint(String endpoint, Map<String,Object> requiredParametersMap)Populate the parameters in the endpoint with its corresponding value and update the base endpoint.PrepareStatementResponseprepareStatement(PrepareStatementRequest request)Prepare a SQL statement for use in a query with variable substitution.QueryResponsequery(QueryRequest request)Execute a SQL query.voidrefreshClient()Rebuild the backingHttpClient.voidsetEndpoint(String endpoint)voidsetRegion(Region region)Sets the region to call (ex, Region.US_PHOENIX_1).voidsetRegion(String regionId)Sets the region to call (ex, ‘us-phoenix-1’).SummarizeStatementResponsesummarizeStatement(SummarizeStatementRequest request)Check the syntax and return a brief summary of a SQL statement.UnassignKmsKeyResponseunassignKmsKey(UnassignKmsKeyRequest request)Removes the global encryption key, if such exists, from a Hosted Environment, reverting to Oracle-managed encryption.voidupdateBaseEndpoint(String endpoint)This method should be used for parameterized endpoint templates only.UpdateConfigurationResponseupdateConfiguration(UpdateConfigurationRequest request)Updates the service-level configuration.UpdateRowResponseupdateRow(UpdateRowRequest request)Write a single row into the table.UpdateTableResponseupdateTable(UpdateTableRequest request)Alter the table identified by tableNameOrId, changing schema, limits, or tagsvoiduseRealmSpecificEndpointTemplate(boolean useOfRealmSpecificEndpointTemplateEnabled)This method should be used to enable or disable the use of realm-specific endpoint template.-
Methods inherited from class com.oracle.bmc.http.internal.BaseSyncClient
clientCall
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface java.lang.AutoCloseable
close
-
Methods inherited from interface com.oracle.bmc.nosql.Nosql
getEndpoint, refreshClient, setEndpoint, useRealmSpecificEndpointTemplate
-
-
-
-
Constructor Detail
-
NosqlClient
@Deprecated public NosqlClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeNosqlClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))
-
NosqlClient
@Deprecated public NosqlClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeNosqlClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configuration
-
NosqlClient
@Deprecated public NosqlClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeNosqlClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
-
NosqlClient
@Deprecated public NosqlClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeNosqlClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)defaultRequestSignerFactory-ClientBuilderBase.requestSignerFactory
-
NosqlClient
@Deprecated public NosqlClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeNosqlClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)defaultRequestSignerFactory-ClientBuilderBase.requestSignerFactoryadditionalClientConfigurators-ClientBuilderBase.additionalClientConfigurators
-
NosqlClient
@Deprecated public NosqlClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeNosqlClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)defaultRequestSignerFactory-ClientBuilderBase.requestSignerFactoryadditionalClientConfigurators-ClientBuilderBase.additionalClientConfiguratorsendpoint-ClientBuilderBase.endpoint(java.lang.String)
-
NosqlClient
@Deprecated public NosqlClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeNosqlClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)defaultRequestSignerFactory-ClientBuilderBase.requestSignerFactoryadditionalClientConfigurators-ClientBuilderBase.additionalClientConfiguratorsendpoint-ClientBuilderBase.endpoint(java.lang.String)signingStrategyRequestSignerFactories-ClientBuilderBase.signingStrategyRequestSignerFactories
-
NosqlClient
@Deprecated public NosqlClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint, ExecutorService executorService)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeNosqlClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)defaultRequestSignerFactory-ClientBuilderBase.requestSignerFactoryadditionalClientConfigurators-ClientBuilderBase.additionalClientConfiguratorsendpoint-ClientBuilderBase.endpoint(java.lang.String)signingStrategyRequestSignerFactories-ClientBuilderBase.signingStrategyRequestSignerFactoriesexecutorService-NosqlClient.Builder.executorService
-
-
Method Detail
-
builder
public static NosqlClient.Builder builder()
Create a builder for this client.- Returns:
- builder
-
setRegion
public void setRegion(Region region)
Description copied from interface:NosqlSets the region to call (ex, Region.US_PHOENIX_1).Note, this will call
setEndpointafter resolving the endpoint. If the service is not available in this Region, however, an IllegalArgumentException will be raised.
-
setRegion
public void setRegion(String regionId)
Description copied from interface:NosqlSets the region to call (ex, ‘us-phoenix-1’).Note, this will first try to map the region ID to a known Region and call
setRegion.If no known Region could be determined, it will create an endpoint based on the default endpoint format (
Region.formatDefaultRegionEndpoint(Service, String)and then callsetEndpoint.
-
changeTableCompartment
public ChangeTableCompartmentResponse changeTableCompartment(ChangeTableCompartmentRequest request)
Description copied from interface:NosqlChange a table’s compartment.- Specified by:
changeTableCompartmentin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
createIndex
public CreateIndexResponse createIndex(CreateIndexRequest request)
Description copied from interface:NosqlCreate a new index on the table identified by tableNameOrId.- Specified by:
createIndexin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
createReplica
public CreateReplicaResponse createReplica(CreateReplicaRequest request)
Description copied from interface:NosqlAdd a replica for this table.The table’s schema must be frozen prior to this operation.
- Specified by:
createReplicain interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
createTable
public CreateTableResponse createTable(CreateTableRequest request)
Description copied from interface:NosqlCreate a new table.- Specified by:
createTablein interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
deleteIndex
public DeleteIndexResponse deleteIndex(DeleteIndexRequest request)
Description copied from interface:NosqlDelete an index from the table identified by tableNameOrId.- Specified by:
deleteIndexin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
deleteReplica
public DeleteReplicaResponse deleteReplica(DeleteReplicaRequest request)
Description copied from interface:NosqlDelete the specified replica table in the remote region.- Specified by:
deleteReplicain interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
deleteRow
public DeleteRowResponse deleteRow(DeleteRowRequest request)
Description copied from interface:NosqlDelete a single row from the table, by primary key.
-
deleteTable
public DeleteTableResponse deleteTable(DeleteTableRequest request)
Description copied from interface:NosqlDelete a table by tableNameOrId.- Specified by:
deleteTablein interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
deleteWorkRequest
public DeleteWorkRequestResponse deleteWorkRequest(DeleteWorkRequestRequest request)
Description copied from interface:NosqlCancel a work request operation with the given ID.- Specified by:
deleteWorkRequestin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getConfiguration
public GetConfigurationResponse getConfiguration(GetConfigurationRequest request)
Description copied from interface:NosqlRetrieves the current service-level configuration.The service may of the standard MULTI_TENANCY type, or of the HOSTED environment type. In the latter case, information about the current state of the environment’s global encryption key is included in the response.
- Specified by:
getConfigurationin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getIndex
public GetIndexResponse getIndex(GetIndexRequest request)
Description copied from interface:NosqlGet information about a single index.
-
getRow
public GetRowResponse getRow(GetRowRequest request)
Description copied from interface:NosqlGet a single row from the table by primary key.
-
getTable
public GetTableResponse getTable(GetTableRequest request)
Description copied from interface:NosqlGet table info by identifier.
-
getWorkRequest
public GetWorkRequestResponse getWorkRequest(GetWorkRequestRequest request)
Description copied from interface:NosqlGet the status of the work request with the given ID.- Specified by:
getWorkRequestin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listIndexes
public ListIndexesResponse listIndexes(ListIndexesRequest request)
Description copied from interface:NosqlGet a list of indexes on a table.- Specified by:
listIndexesin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listTableUsage
public ListTableUsageResponse listTableUsage(ListTableUsageRequest request)
Description copied from interface:NosqlGet table usage info.- Specified by:
listTableUsagein interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listTables
public ListTablesResponse listTables(ListTablesRequest request)
Description copied from interface:NosqlGet a list of tables in a compartment.- Specified by:
listTablesin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listWorkRequestErrors
public ListWorkRequestErrorsResponse listWorkRequestErrors(ListWorkRequestErrorsRequest request)
Description copied from interface:NosqlReturn a (paginated) list of errors for a given work request.- Specified by:
listWorkRequestErrorsin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listWorkRequestLogs
public ListWorkRequestLogsResponse listWorkRequestLogs(ListWorkRequestLogsRequest request)
Description copied from interface:NosqlReturn a (paginated) list of logs for a given work request.- Specified by:
listWorkRequestLogsin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listWorkRequests
public ListWorkRequestsResponse listWorkRequests(ListWorkRequestsRequest request)
Description copied from interface:NosqlList the work requests in a compartment.- Specified by:
listWorkRequestsin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
prepareStatement
public PrepareStatementResponse prepareStatement(PrepareStatementRequest request)
Description copied from interface:NosqlPrepare a SQL statement for use in a query with variable substitution.- Specified by:
prepareStatementin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
query
public QueryResponse query(QueryRequest request)
Description copied from interface:NosqlExecute a SQL query.
-
summarizeStatement
public SummarizeStatementResponse summarizeStatement(SummarizeStatementRequest request)
Description copied from interface:NosqlCheck the syntax and return a brief summary of a SQL statement.- Specified by:
summarizeStatementin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
unassignKmsKey
public UnassignKmsKeyResponse unassignKmsKey(UnassignKmsKeyRequest request)
Description copied from interface:NosqlRemoves the global encryption key, if such exists, from a Hosted Environment, reverting to Oracle-managed encryption.- Specified by:
unassignKmsKeyin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
updateConfiguration
public UpdateConfigurationResponse updateConfiguration(UpdateConfigurationRequest request)
Description copied from interface:NosqlUpdates the service-level configuration.The discriminator value
UpdateConfigurationDetails.environmentmust match the service’s environment type.- Specified by:
updateConfigurationin interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
updateRow
public UpdateRowResponse updateRow(UpdateRowRequest request)
Description copied from interface:NosqlWrite a single row into the table.
-
updateTable
public UpdateTableResponse updateTable(UpdateTableRequest request)
Description copied from interface:NosqlAlter the table identified by tableNameOrId, changing schema, limits, or tags- Specified by:
updateTablein interfaceNosql- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getWaiters
public NosqlWaiters getWaiters()
Description copied from interface:NosqlGets the pre-configured waiters available for resources for this service.- Specified by:
getWaitersin interfaceNosql- Returns:
- The service waiters.
-
getPaginators
public NosqlPaginators getPaginators()
Description copied from interface:NosqlGets the pre-configured paginators available for list operations in this service which may return multiple pages of data.These paginators provide an
Iterableinterface so that service responses, or resources/records, can be iterated through without having to manually deal with pagination and page tokens.- Specified by:
getPaginatorsin interfaceNosql- Returns:
- The service paginators.
-
getDefaultConfigurator
protected ClientConfigurator getDefaultConfigurator()
-
useRealmSpecificEndpointTemplate
public void useRealmSpecificEndpointTemplate(boolean useOfRealmSpecificEndpointTemplateEnabled)
This method should be used to enable or disable the use of realm-specific endpoint template.The default value is null. To enable the use of endpoint template defined for the realm in use, set the flag to true To disable the use of endpoint template defined for the realm in use, set the flag to false
- Parameters:
useOfRealmSpecificEndpointTemplateEnabled- This flag can be set to true or false to enable or disable the use of realm-specific endpoint template respectively
-
populateServiceParametersInEndpoint
public final void populateServiceParametersInEndpoint(String endpoint, Map<String,Object> requiredParametersMap)
Populate the parameters in the endpoint with its corresponding value and update the base endpoint.The value will be populated iff the parameter in endpoint is a required request path parameter or a required request query parameter. If not, the parameter in the endpoint will be ignored and left blank.
- Parameters:
endpoint- The endpoint template in userequiredParametersMap- Map of parameter name as key and value set in request path or query parameter as value
-
updateBaseEndpoint
public final void updateBaseEndpoint(String endpoint)
This method should be used for parameterized endpoint templates only.This does not include {region} and {secondLevelDomain} parameters.
- Parameters:
endpoint- The updated endpoint to use
-
setEndpoint
public final void setEndpoint(String endpoint)
-
getEndpoint
public final String getEndpoint()
-
refreshClient
public final void refreshClient()
Rebuild the backingHttpClient.This will call
ClientConfigurators again, and can be used to e.g. refresh the SSL certificate.
-
close
public final void close()
- Specified by:
closein interfaceAutoCloseable
-
getClientCommonLibraryVersion
public String getClientCommonLibraryVersion()
-
-