org.springframework.data.mongodb.core.query

Class Update

java.lang.Object

org.springframework.data.mongodb.core.query.Update

Direct Known Subclasses:

BasicUpdate

public class Update
extends Object

Class to easily construct MongoDB update clauses.

Author:

Thomas Risberg, Mark Pollack, Oliver Gierke, Becca Gaspard, Christoph Strobl, Thomas Darimont, Alexey Plotnik, Mark Paluch, Pavel Vodrazka

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	Update.AddToSetBuilder Builder for creating $addToSet modifier.
static class	Update.BitwiseOperatorBuilder
static interface	Update.Modifier Marker interface of nested commands.
static class	Update.Modifiers Modifiers holds a distinct collection of Update.Modifier
static class	Update.Position
class	Update.PushOperatorBuilder Builder for creating $push modifiers

Constructor Summary

Constructors

Constructor and Description
Update()

Method Summary

Modifier and Type	Method and Description
protected void	addFieldOperation(String operator, String key, Object value) Deprecated.
protected void	addMultiFieldOperation(String operator, String key, Object value)
Update.AddToSetBuilder	addToSet(String key) Update using $addToSet modifier.
Update	addToSet(String key, Object value) Update using the $addToSet update modifier
Update.BitwiseOperatorBuilder	bitwise(String key) The operator supports bitwise and, bitwise or, and bitwise xor operations.
Update	currentDate(String key) Update given key to current date using $currentDate modifier.
Update	currentTimestamp(String key) Update given key to current date using $currentDate : { $type : "timestamp" } modifier.
boolean	equals(Object obj)
static Update	fromDocument(org.bson.Document object, String... exclude) Creates an Update instance from the given Document.
org.bson.Document	getUpdateObject()
int	hashCode()
Update	inc(String key, Number inc) Update using the $inc update modifier
Boolean	isIsolated()
Update	isolated() Prevents a write operation that affects multiple documents from yielding to other reads or writes once the first document is written.
Update	max(String key, Object value) Update given key to the value if the value is greater than the current value of the field.
Update	min(String key, Object value) Update given key to the value if the value is less than the current value of the field.
boolean	modifies(String key) Determine if a given key will be touched on execution.
Update	multiply(String key, Number multiplier) Multiply the value of given key by the given number.
Update	pop(String key, Update.Position pos) Update using the $pop update modifier
Update	pull(String key, Object value) Update using the $pull update modifier
Update	pullAll(String key, Object[] values) Update using the $pullAll update modifier
Update.PushOperatorBuilder	push(String key) Update using $push modifier.
Update	push(String key, Object value) Update using the $push update modifier
Update	pushAll(String key, Object[] values) Update using the $pushAll update modifier.
Update	rename(String oldName, String newName) Update using the $rename update modifier
Update	set(String key, Object value) Update using the $set update modifier
Update	setOnInsert(String key, Object value) Update using the $setOnInsert update modifier
String	toString()
Update	unset(String key) Update using the $unset update modifier
static Update	update(String key, Object value) Static factory method to create an Update using the provided key

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Update

public Update()

Method Detail

update

public static Update update(String key,
                            Object value)

Static factory method to create an Update using the provided key

Parameters:

key -

Returns:

fromDocument

public static Update fromDocument(org.bson.Document object,
                                  String... exclude)

Creates an Update instance from the given Document. Allows to explicitly exclude fields from making it into the created Update object. Note, that this will set attributes directly and not use $set. This means fields not given in the Document will be nulled when executing the update. To create an only-updating Update instance of a Document, call set(String, Object) for each value in it.

Parameters:

object - the source Document to create the update from.

exclude - the fields to exclude.

Returns:

set

public Update set(String key,
                  Object value)

Update using the $set update modifier

Parameters:

key -

value -

Returns:

See Also:

MongoDB Update operator: $set

setOnInsert

public Update setOnInsert(String key,
                          Object value)

Update using the $setOnInsert update modifier

Parameters:

key -

value -

Returns:

See Also:

MongoDB Update operator: $setOnInsert

unset

public Update unset(String key)

Update using the $unset update modifier

Parameters:

key -

Returns:

See Also:

MongoDB Update operator: $unset

inc

public Update inc(String key,
                  Number inc)

Update using the $inc update modifier

Parameters:

key -

inc -

Returns:

See Also:

MongoDB Update operator: $inc

push

public Update push(String key,
                   Object value)

Update using the $push update modifier

Parameters:

key -

value -

Returns:

See Also:

MongoDB Update operator: $push

push

public Update.PushOperatorBuilder push(String key)

Update using $push modifier.
Allows creation of $push command for single or multiple (using $each) values as well as using $position.

Parameters:

key -

Returns:

Update.PushOperatorBuilder for given key

See Also:

MongoDB Update operator: $push, MongoDB Update operator: $each

pushAll

public Update pushAll(String key,
                      Object[] values)

Update using the $pushAll update modifier.
Note: In mongodb 2.4 the usage of $pushAll has been deprecated in favor of $push $each. push(String)) returns a builder that can be used to populate the $each object.

Parameters:

key -

values -

Returns:

See Also:

MongoDB Update operator: $pushAll

addToSet

public Update.AddToSetBuilder addToSet(String key)

Update using $addToSet modifier.
Allows creation of $push command for single or multiple (using $each) values

Parameters:

key -

Returns:

Since:

1.5

addToSet

public Update addToSet(String key,
                       Object value)

Update using the $addToSet update modifier

Parameters:

key -

value -

Returns:

See Also:

MongoDB Update operator: $addToSet

pop

public Update pop(String key,
                  Update.Position pos)

Update using the $pop update modifier

Parameters:

key -

pos -

Returns:

See Also:

MongoDB Update operator: $pop

pull

public Update pull(String key,
                   Object value)

Update using the $pull update modifier

Parameters:

key -

value -

Returns:

See Also:

MongoDB Update operator: $pull

pullAll

public Update pullAll(String key,
                      Object[] values)

Update using the $pullAll update modifier

Parameters:

key -

values -

Returns:

See Also:

MongoDB Update operator: $pullAll

rename

public Update rename(String oldName,
                     String newName)

Update using the $rename update modifier

Parameters:

oldName -

newName -

Returns:

See Also:

MongoDB Update operator: $rename

currentDate

public Update currentDate(String key)

Update given key to current date using $currentDate modifier.

Parameters:

key -

Returns:

Since:

1.6

See Also:

MongoDB Update operator: $currentDate

currentTimestamp

public Update currentTimestamp(String key)

Update given key to current date using $currentDate : { $type : "timestamp" } modifier.

Parameters:

key -

Returns:

Since:

1.6

See Also:

MongoDB Update operator: $currentDate

multiply

public Update multiply(String key,
                       Number multiplier)

Multiply the value of given key by the given number.

Parameters:

key - must not be null.

multiplier - must not be null.

Returns:

Since:

1.7

See Also:

MongoDB Update operator: $mul

max

public Update max(String key,
                  Object value)

Update given key to the value if the value is greater than the current value of the field.

Parameters:

key - must not be null.

value - must not be null.

Returns:

Since:

1.10

See Also:

Comparison/Sort Order, MongoDB Update operator: $max

min

public Update min(String key,
                  Object value)

Update given key to the value if the value is less than the current value of the field.

Parameters:

key - must not be null.

value - must not be null.

Returns:

Since:

1.10

See Also:

Comparison/Sort Order, MongoDB Update operator: $min

bitwise

public Update.BitwiseOperatorBuilder bitwise(String key)

The operator supports bitwise and, bitwise or, and bitwise xor operations.

Parameters:

key -

Returns:

Since:

1.7

isolated

public Update isolated()

Prevents a write operation that affects multiple documents from yielding to other reads or writes once the first document is written.
Use with MongoOperations.updateMulti(Query, Update, Class).

Returns:

never null.

Since:

2.0

isIsolated

public Boolean isIsolated()

Returns:

true if update isolated is set.

Since:

2.0

getUpdateObject

public org.bson.Document getUpdateObject()

addFieldOperation

@Deprecated
protected void addFieldOperation(String operator,
                                             String key,
                                             Object value)

Deprecated.

This method is not called anymore rather override addMultiFieldOperation(String, String, Object).

Parameters:

operator -

key -

value -

addMultiFieldOperation

protected void addMultiFieldOperation(String operator,
                                      String key,
                                      Object value)

modifies

public boolean modifies(String key)

Determine if a given key will be touched on execution.

Parameters:

key -

Returns:

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object