com.mongodb.operation

Class CreateCollectionOperation

java.lang.Object

com.mongodb.operation.CreateCollectionOperation

All Implemented Interfaces:

AsyncWriteOperation<Void>, WriteOperation<Void>

public class CreateCollectionOperation
extends Object
implements AsyncWriteOperation<Void>, WriteOperation<Void>

An operation to create a collection

Since:

3.0

Constructor Summary

Constructors

Constructor and Description
CreateCollectionOperation(String databaseName, String collectionName) Construct a new instance.

Method Summary

Methods

Modifier and Type	Method and Description
CreateCollectionOperation	autoIndex(boolean autoIndex) Sets if _id field of the collection is indexed.
CreateCollectionOperation	capped(boolean capped) Sets whether the collection is capped.
Void	execute(WriteBinding binding) General execute which can return anything of type T
void	executeAsync(AsyncWriteBinding binding, SingleResultCallback<Void> callback) General execute which can return anything of type T
String	getCollectionName() Gets the name of the collection to create.
long	getMaxDocuments() Gets the maximum number of documents allowed in the collection.
long	getSizeInBytes() Gets the maximum size of the collection in bytes.
BsonDocument	getStorageEngineOptions() Gets the storage engine options document for this collection.
boolean	isAutoIndex() The auto index value.
boolean	isCapped() Gets whether the collection is capped.
Boolean	isUsePowerOf2Sizes() Gets whether usePowerOf2Sizes should be used foe the allocation strategy.
CreateCollectionOperation	maxDocuments(long maxDocuments) Set the maximum number of documents in the collection.
CreateCollectionOperation	sizeInBytes(long sizeInBytes) Sets the maximum size of the collection in bytes.
CreateCollectionOperation	storageEngineOptions(BsonDocument storageEngineOptions) Sets the storage engine options document for this collection.
CreateCollectionOperation	usePowerOf2Sizes(Boolean usePowerOf2Sizes) Sets whether usePowerOf2Sizes should be used foe the allocation strategy.

Methods inherited from class java.lang.Object

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

Constructor Detail

CreateCollectionOperation

public CreateCollectionOperation(String databaseName,
                         String collectionName)

Construct a new instance.

Parameters:

databaseName - the name of the database for the operation.

collectionName - the name of the collection to be created.

Method Detail

getCollectionName

public String getCollectionName()

Gets the name of the collection to create.

Returns:

the collection name

isAutoIndex

public boolean isAutoIndex()

The auto index value.

Returns:

true if auto-index is enabled

autoIndex

public CreateCollectionOperation autoIndex(boolean autoIndex)

Sets if _id field of the collection is indexed. Only applies to capped collections and defaults to true.

Parameters:

autoIndex - true if auto-index of _id is enabled. Only applies to capped collections.

Returns:

this

getMaxDocuments

public long getMaxDocuments()

Gets the maximum number of documents allowed in the collection.

Returns:

max number of documents in the collection

maxDocuments

public CreateCollectionOperation maxDocuments(long maxDocuments)

Set the maximum number of documents in the collection. Only applies to capped collections

Parameters:

maxDocuments - the maximum number of documents in the collection. Only applies to capped collections.

Returns:

this

isCapped

public boolean isCapped()

Gets whether the collection is capped.

Returns:

whether the collection is capped

capped

public CreateCollectionOperation capped(boolean capped)

Sets whether the collection is capped. Capped collections also require the size set see sizeInBytes.

Parameters:

capped - whether the collection is capped. Defaults to false.

Returns:

this

getSizeInBytes

public long getSizeInBytes()

Gets the maximum size of the collection in bytes.

Returns:

the maximum size of the collection

sizeInBytes

public CreateCollectionOperation sizeInBytes(long sizeInBytes)

Sets the maximum size of the collection in bytes. Required for capped collections.

Parameters:

sizeInBytes - the maximum size of the collection

Returns:

this

isUsePowerOf2Sizes

public Boolean isUsePowerOf2Sizes()

Gets whether usePowerOf2Sizes should be used foe the allocation strategy.

Note: usePowerOf2Sizes} became the default allocation strategy in mongodb 2.6

Returns:

usePowerOf2Sizes became the default allocation strategy

MongoDB documentation

usePowerOf2Sizes

Since server release

2.6

usePowerOf2Sizes

public CreateCollectionOperation usePowerOf2Sizes(Boolean usePowerOf2Sizes)

Sets whether usePowerOf2Sizes should be used foe the allocation strategy.

Note: usePowerOf2Sizes} became the default allocation strategy in mongodb 2.6

Parameters:

usePowerOf2Sizes - as the default allocation strategy

Returns:

this

MongoDB documentation

usePowerOf2Sizes

Since server release

2.6

getStorageEngineOptions

public BsonDocument getStorageEngineOptions()

Gets the storage engine options document for this collection.

Returns:

the storage engine options

Since server release

2.8

storageEngineOptions

public CreateCollectionOperation storageEngineOptions(BsonDocument storageEngineOptions)

Sets the storage engine options document for this collection.

Parameters:

storageEngineOptions - the storate engine options

Returns:

this

Since server release

2.8

execute

public Void execute(WriteBinding binding)

Description copied from interface: WriteOperation

General execute which can return anything of type T

Specified by:

execute in interface WriteOperation<Void>

Parameters:

binding - the binding to execute in the context of

Returns:

T, the result of the execution

executeAsync

public void executeAsync(AsyncWriteBinding binding,
                SingleResultCallback<Void> callback)

Description copied from interface: AsyncWriteOperation

General execute which can return anything of type T

Specified by:

executeAsync in interface AsyncWriteOperation<Void>

Parameters:

binding - the binding to execute in the context of

callback - the callback to be called when the operation has been executed