org.springframework.data.mongodb.core.aggregation

Class MergeOperation.MergeOperationBuilder

java.lang.Object

org.springframework.data.mongodb.core.aggregation.MergeOperation.MergeOperationBuilder

Enclosing class:

MergeOperation

public static class MergeOperation.MergeOperationBuilder
extends Object

Builder API to construct a MergeOperation.

Since:

2.3

Author:

Christoph Strobl

Constructor Summary

Constructors

Constructor and Description
MergeOperationBuilder()

Method Summary

Modifier and Type	Method and Description
MergeOperation	build()
MergeOperation.MergeOperationBuilder	exposeVariablesOf(VariableOperators.Let let) Expose the variables defined by VariableOperators.Let to the update aggregation.
MergeOperation.MergeOperationBuilder	id(MergeOperation.UniqueMergeId id) Set the identifier that determines if a results document matches an already existing document in the output collection.
MergeOperation.MergeOperationBuilder	inDatabase(String database) Optionally define a target database if different from the current one.
MergeOperation.MergeOperationBuilder	into(MergeOperation.MergeOperationTarget into) Define the target to store results in.
MergeOperation.MergeOperationBuilder	intoCollection(String collection) Required output collection name to store results to.
MergeOperation.MergeOperationBuilder	let(VariableOperators.Let let) Expose the variables defined by VariableOperators.Let to the update aggregation.
MergeOperation.MergeOperationBuilder	on(String... fields) Appends a single field or multiple fields that act as a unique identifier for a document.
MergeOperation.MergeOperationBuilder	target(MergeOperation.MergeOperationTarget target) Define the target to store results in.
MergeOperation.MergeOperationBuilder	whenDocumentsDontMatch(MergeOperation.WhenDocumentsDontMatch whenNotMatched) The action to take place when documents do not already exist in the target collection.
MergeOperation.MergeOperationBuilder	whenDocumentsMatch(MergeOperation.WhenDocumentsMatch whenMatched) The action to take place when documents already exist in the target collection.
MergeOperation.MergeOperationBuilder	whenDocumentsMatchApply(Aggregation aggregation) The action to take place when documents already exist in the target collection.
MergeOperation.MergeOperationBuilder	whenMatched(MergeOperation.WhenDocumentsMatch whenMatched) The action to take place when documents already exist in the target collection.
MergeOperation.MergeOperationBuilder	whenNotMatched(MergeOperation.WhenDocumentsDontMatch whenNotMatched) The action to take place when documents do not already exist in the target collection.

Methods inherited from class java.lang.Object

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

Constructor Detail

MergeOperationBuilder

public MergeOperationBuilder()

Method Detail

intoCollection

public MergeOperation.MergeOperationBuilder intoCollection(String collection)

Required output collection name to store results to.

Parameters:

collection - must not be null nor empty.

Returns:

this.

inDatabase

public MergeOperation.MergeOperationBuilder inDatabase(String database)

Optionally define a target database if different from the current one.

Parameters:

database - must not be null.

Returns:

this.

into

public MergeOperation.MergeOperationBuilder into(MergeOperation.MergeOperationTarget into)

Define the target to store results in.

Parameters:

into - must not be null.

Returns:

this.

target

public MergeOperation.MergeOperationBuilder target(MergeOperation.MergeOperationTarget target)

Define the target to store results in.

Parameters:

target - must not be null.

Returns:

this.

on

public MergeOperation.MergeOperationBuilder on(String... fields)

Appends a single field or multiple fields that act as a unique identifier for a document. The identifier determines if a results document matches an already existing document in the output collection.
The aggregation results documents must contain the field(s) specified via on, unless it's the _id field.

Parameters:

fields - must not be null.

Returns:

this.

id

public MergeOperation.MergeOperationBuilder id(MergeOperation.UniqueMergeId id)

Set the identifier that determines if a results document matches an already existing document in the output collection.

Parameters:

id - must not be null.

Returns:

this.

let

public MergeOperation.MergeOperationBuilder let(VariableOperators.Let let)

Expose the variables defined by VariableOperators.Let to the update aggregation.

Parameters:

let - the variable expressions

Returns:

this.

exposeVariablesOf

public MergeOperation.MergeOperationBuilder exposeVariablesOf(VariableOperators.Let let)

Expose the variables defined by VariableOperators.Let to the update aggregation.

Parameters:

let - the variable expressions

Returns:

this.

whenMatched

public MergeOperation.MergeOperationBuilder whenMatched(MergeOperation.WhenDocumentsMatch whenMatched)

The action to take place when documents already exist in the target collection.

Parameters:

whenMatched - must not be null.

Returns:

this.

whenDocumentsMatch

public MergeOperation.MergeOperationBuilder whenDocumentsMatch(MergeOperation.WhenDocumentsMatch whenMatched)

The action to take place when documents already exist in the target collection.

Parameters:

whenMatched - must not be null.

Returns:

this.

whenDocumentsMatchApply

public MergeOperation.MergeOperationBuilder whenDocumentsMatchApply(Aggregation aggregation)

The action to take place when documents already exist in the target collection.

Parameters:

aggregation - must not be null.

Returns:

this.

whenNotMatched

public MergeOperation.MergeOperationBuilder whenNotMatched(MergeOperation.WhenDocumentsDontMatch whenNotMatched)

The action to take place when documents do not already exist in the target collection.

Parameters:

whenNotMatched - must not be null.

Returns:

this.

whenDocumentsDontMatch

public MergeOperation.MergeOperationBuilder whenDocumentsDontMatch(MergeOperation.WhenDocumentsDontMatch whenNotMatched)

The action to take place when documents do not already exist in the target collection.

Parameters:

whenNotMatched - must not be null.

Returns:

this.

build

public MergeOperation build()

Returns:

new instance of MergeOperation.