Package com.couchbase.client.java.manager.collection

Class AsyncCollectionManager

java.lang.Object

com.couchbase.client.java.manager.collection.AsyncCollectionManager

@Volatile
public class AsyncCollectionManager
extends Object

The AsyncCollectionManager provides APIs to manage collections and scopes within a bucket.

Constructor Summary

Constructors

Constructor	Description
AsyncCollectionManager(CoreCollectionManager coreCollectionManager, AsyncCluster cluster)	Creates a new AsyncCollectionManager.

Method Summary

Modifier and Type	Method	Description
CompletableFuture<Void>	createCollection(CollectionSpec collectionSpec)	Deprecated. This method cannot be used to set the collection's "history" property.
CompletableFuture<Void>	createCollection(CollectionSpec collectionSpec, CreateCollectionOptions options)	Deprecated. This method cannot be used to set the collection's "history" property.
CompletableFuture<Void>	createCollection(String scopeName, String collectionName, CreateCollectionSettings settings)	Creates a collection if it does not already exist with custom options.
CompletableFuture<Void>	createCollection(String scopeName, String collectionName, CreateCollectionSettings settings, CreateCollectionOptions options)	Creates a collection if it does not already exist with custom options.
CompletableFuture<Void>	createScope(String scopeName)	Creates a scope if it does not already exist.
CompletableFuture<Void>	createScope(String scopeName, CreateScopeOptions options)	Creates a scope if it does not already exist with custom options.
CompletableFuture<Void>	dropCollection(CollectionSpec collectionSpec)	Deprecated. Please use dropCollection(String, String) instead.
CompletableFuture<Void>	dropCollection(CollectionSpec collectionSpec, DropCollectionOptions options)	Deprecated. Please use dropCollection(String, String, DropCollectionOptions) instead.
CompletableFuture<Void>	dropCollection(String scopeName, String collectionName)	Drops a collection if it exists.
CompletableFuture<Void>	dropCollection(String scopeName, String collectionName, DropCollectionOptions options)	Drops a collection if it exists with custom options.
CompletableFuture<Void>	dropScope(String scopeName)	Drops a scope if it exists.
CompletableFuture<Void>	dropScope(String scopeName, DropScopeOptions options)	Drops a scope if it exists with custom options.
CompletableFuture<List<ScopeSpec>>	getAllScopes()	Returns all scopes in this bucket.
CompletableFuture<List<ScopeSpec>>	getAllScopes(GetAllScopesOptions options)	Returns all scopes in this bucket with custom options.
CompletableFuture<ScopeSpec>	getScope(String scopeName)	Deprecated. use getAllScopes() instead.
CompletableFuture<ScopeSpec>	getScope(String scopeName, GetScopeOptions options)	Deprecated. use getAllScopes(GetAllScopesOptions) instead.
CompletableFuture<Void>	updateCollection(String scopeName, String collectionName, UpdateCollectionSettings settings)	Updates a collection with custom options.
CompletableFuture<Void>	updateCollection(String scopeName, String collectionName, UpdateCollectionSettings settings, UpdateCollectionOptions options)	Updates a collection with custom options.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

AsyncCollectionManager

@Internal
public AsyncCollectionManager(CoreCollectionManager coreCollectionManager,
 AsyncCluster cluster)

Creates a new AsyncCollectionManager.

This API is not intended to be called by the user directly, use AsyncBucket.collections() instead.

Method Details

createCollection

@Deprecated
public CompletableFuture<Void> createCollection(CollectionSpec collectionSpec)

Deprecated.

This method cannot be used to set the collection's "history" property. Please use createCollection(String, String, CreateCollectionSettings) instead.

Creates a collection if it does not already exist.

Note that a scope needs to be created first (via createScope(String)) if it doesn't exist already.

Parameters:

collectionSpec - the collection spec that contains the properties of the collection.

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

CollectionExistsException - (async) if the collection already exists

ScopeNotFoundException - (async) if the specified scope does not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

createCollection

@Deprecated
public CompletableFuture<Void> createCollection(CollectionSpec collectionSpec,
 CreateCollectionOptions options)

Deprecated.

This method cannot be used to set the collection's "history" property. Please use createCollection(String, String, CreateCollectionSettings, CreateCollectionOptions) instead.

Creates a collection if it does not already exist with custom options.

Note that a scope needs to be created first (via createScope(String)) if it doesn't exist already.

Parameters:

collectionSpec - the collection spec that contains the properties of the collection.

options - the custom options to apply.

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

CollectionExistsException - (async) if the collection already exists

ScopeNotFoundException - (async) if the specified scope does not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

createCollection

@Volatile
public CompletableFuture<Void> createCollection(String scopeName,
 String collectionName,
 CreateCollectionSettings settings)

Creates a collection if it does not already exist with custom options.

Note that a scope needs to be created first (via createScope(String)) if it doesn't exist already.

Parameters:

scopeName - name of scope to create collection in

collectionName - name of collection to create

settings - the collection settings

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

CollectionExistsException - (async) if the collection already exists

ScopeNotFoundException - (async) if the specified scope does not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

createCollection

@Volatile
public CompletableFuture<Void> createCollection(String scopeName,
 String collectionName,
 CreateCollectionSettings settings,
 CreateCollectionOptions options)

Creates a collection if it does not already exist with custom options.

Note that a scope needs to be created first (via createScope(String)) if it doesn't exist already.

Parameters:

scopeName - name of scope to create collection in

collectionName - name of collection to create

settings - the collection settings

options - the custom options to apply.

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

CollectionExistsException - (async) if the collection already exists

ScopeNotFoundException - (async) if the specified scope does not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

createScope

public CompletableFuture<Void> createScope(String scopeName)

Creates a scope if it does not already exist.

Parameters:

scopeName - the name of the scope to create.

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

ScopeExistsException - (async) if the scope already exists.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

createScope

public CompletableFuture<Void> createScope(String scopeName,
 CreateScopeOptions options)

Creates a scope if it does not already exist with custom options.

Parameters:

scopeName - the name of the scope to create.

options - the custom options to apply.

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

ScopeExistsException - (async) if the scope already exists.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

updateCollection

@Volatile
public CompletableFuture<Void> updateCollection(String scopeName,
 String collectionName,
 UpdateCollectionSettings settings)

Updates a collection with custom options.

Parameters:

scopeName - name of scope to update collection in

collectionName - name of collection to update

settings - the collection settings

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

ScopeNotFoundException - (async) if the specified scope does not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

updateCollection

@Volatile
public CompletableFuture<Void> updateCollection(String scopeName,
 String collectionName,
 UpdateCollectionSettings settings,
 UpdateCollectionOptions options)

Updates a collection with custom options.

Parameters:

scopeName - name of scope to update collection in

collectionName - name of collection to update

settings - the collection settings

options - the custom options to apply.

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

CollectionNotFoundException - (async) if the collection does not exist.

ScopeNotFoundException - (async) if the specified scope does not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

dropCollection

@Deprecated
public CompletableFuture<Void> dropCollection(CollectionSpec collectionSpec)

Deprecated.

Please use dropCollection(String, String) instead.

Drops a collection if it exists.

Parameters:

collectionSpec - the collection spec that contains the properties of the collection.

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

CollectionNotFoundException - (async) if the collection does not exist.

ScopeNotFoundException - (async) if the specified scope does not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

dropCollection

@Deprecated
public CompletableFuture<Void> dropCollection(CollectionSpec collectionSpec,
 DropCollectionOptions options)

Deprecated.

Please use dropCollection(String, String, DropCollectionOptions) instead.

Drops a collection if it exists with custom options.

Parameters:

collectionSpec - the collection spec that contains the properties of the collection.

options - the custom options to apply.

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

CollectionNotFoundException - (async) if the collection did not exist.

ScopeNotFoundException - (async) if the specified scope does not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

dropCollection

@Volatile
public CompletableFuture<Void> dropCollection(String scopeName,
 String collectionName)

Drops a collection if it exists.

Parameters:

scopeName - name of scope to drop collection from

collectionName - name of collection to drop

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

CollectionNotFoundException - (async) if the collection did not exist.

ScopeNotFoundException - (async) if the specified scope does not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

dropCollection

@Volatile
public CompletableFuture<Void> dropCollection(String scopeName,
 String collectionName,
 DropCollectionOptions options)

Drops a collection if it exists with custom options.

Parameters:

scopeName - name of scope to drop collection from

collectionName - name of collection to drop

options - the custom options to apply.

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

CollectionNotFoundException - (async) if the collection did not exist.

ScopeNotFoundException - (async) if the specified scope does not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

dropScope

public CompletableFuture<Void> dropScope(String scopeName)

Drops a scope if it exists.

Parameters:

scopeName - the name of the scope to drop.

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

ScopeNotFoundException - (async) if the scope did not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

dropScope

public CompletableFuture<Void> dropScope(String scopeName,
 DropScopeOptions options)

Drops a scope if it exists with custom options.

Parameters:

scopeName - the name of the scope to drop.

options - the custom options to apply.

Returns:

a CompletableFuture completing when the operation is applied or failed with an error.

Throws:

ScopeNotFoundException - (async) if the scope did not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

getScope

@Deprecated
public CompletableFuture<ScopeSpec> getScope(String scopeName)

Deprecated.

use getAllScopes() instead.

Returns the scope if it exists.

Parameters:

scopeName - the name of the scope.

Returns:

a CompletableFuture containing information about the scope.

Throws:

ScopeNotFoundException - (async) if scope does not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

getScope

@Deprecated
public CompletableFuture<ScopeSpec> getScope(String scopeName,
 GetScopeOptions options)

Deprecated.

use getAllScopes(GetAllScopesOptions) instead.

Returns the scope if it exists with custom options.

Parameters:

scopeName - the name of the scope.

options - the custom options to apply.

Returns:

a CompletableFuture containing information about the scope.

Throws:

ScopeNotFoundException - (async) if scope does not exist.

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

getAllScopes

public CompletableFuture<List<ScopeSpec>> getAllScopes()

Returns all scopes in this bucket.

Returns:

a CompletableFuture with a (potentially empty) list of scopes in the bucket.

Throws:

CouchbaseException - (async) if any other generic unhandled/unexpected errors.

getAllScopes

public CompletableFuture<List<ScopeSpec>> getAllScopes(GetAllScopesOptions options)

Returns all scopes in this bucket with custom options.

Parameters:

options - the custom options to apply.

Returns:

a CompletableFuture with a (potentially empty) list of scopes in the bucket.

Throws:

CouchbaseException - (async) if any other generic unhandled/unexpected errors.