org.springframework.data.mongodb.core

Class CollectionOptions

java.lang.Object

org.springframework.data.mongodb.core.CollectionOptions

public class CollectionOptions
extends Object

Provides a simple wrapper to encapsulate the variety of settings you can use when creating a collection.

Author:

Thomas Risberg, Christoph Strobl, Mark Paluch

Constructor Summary

Constructors

Constructor and Description
CollectionOptions(Long size, Long maxDocuments, Boolean capped) Deprecated. since 2.0 please use empty() as entry point.

Method Summary

Modifier and Type	Method and Description
CollectionOptions	capped() Create new CollectionOptions with already given settings and capped set to true.
CollectionOptions	collation(Collation collation) Create new CollectionOptions with already given settings and collation set to given value.
static CollectionOptions	empty() Create new empty CollectionOptions.
Optional<Boolean>	getCapped() Get if the collection should be capped.
Optional<Collation>	getCollation() Get the Collation settings.
Optional<Long>	getMaxDocuments() Get the max number of documents the collection should be limited to.
Optional<Long>	getSize() Get the size in bytes the collection should be limited to.
static CollectionOptions	just(Collation collation) Create new CollectionOptions by just providing the Collation to use.
CollectionOptions	maxDocuments(long maxDocuments) Create new CollectionOptions with already given settings and maxDocuments set to given value.
CollectionOptions	size(long size) Create new CollectionOptions with already given settings and size set to given value.

Methods inherited from class java.lang.Object

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

Constructor Detail

CollectionOptions

@Deprecated
public CollectionOptions(@Nullable
                                     Long size,
                                     @Nullable
                                     Long maxDocuments,
                                     @Nullable
                                     Boolean capped)

Deprecated. since 2.0 please use empty() as entry point.

Constructs a new CollectionOptions instance.

Parameters:

size - the collection size in bytes, this data space is preallocated. Can be null.

maxDocuments - the maximum number of documents in the collection. Can be null.

capped - true to created a "capped" collection (fixed size with auto-FIFO behavior based on insertion order), false otherwise. Can be null.

Method Detail

just

public static CollectionOptions just(Collation collation)

Create new CollectionOptions by just providing the Collation to use.

Parameters:

collation - must not be null.

Returns:

new CollectionOptions.

Since:

2.0

empty

public static CollectionOptions empty()

Create new empty CollectionOptions.

Returns:

new CollectionOptions.

Since:

2.0

capped

public CollectionOptions capped()

Create new CollectionOptions with already given settings and capped set to true.
NOTE Using capped collections requires defining #size(int).

Returns:

new CollectionOptions.

Since:

2.0

maxDocuments

public CollectionOptions maxDocuments(long maxDocuments)

Create new CollectionOptions with already given settings and maxDocuments set to given value.

Parameters:

maxDocuments - can be null.

Returns:

new CollectionOptions.

Since:

2.0

size

public CollectionOptions size(long size)

Create new CollectionOptions with already given settings and size set to given value.

Parameters:

size - can be null.

Returns:

new CollectionOptions.

Since:

2.0

collation

public CollectionOptions collation(@Nullable
                                   Collation collation)

Create new CollectionOptions with already given settings and collation set to given value.

Parameters:

collation - can be null.

Returns:

new CollectionOptions.

Since:

2.0

getMaxDocuments

public Optional<Long> getMaxDocuments()

Get the max number of documents the collection should be limited to.

Returns:

Optional.empty() if not set.

getSize

public Optional<Long> getSize()

Get the size in bytes the collection should be limited to.

Returns:

Optional.empty() if not set.

getCapped

public Optional<Boolean> getCapped()

Get if the collection should be capped.

Returns:

Optional.empty() if not set.

Since:

2.0

getCollation

public Optional<Collation> getCollation()

Get the Collation settings.

Returns:

Optional.empty() if not set.

Since:

2.0