Package io.vertx.mongo.client.model
Class FindOneAndReplaceOptions
- java.lang.Object
-
- io.vertx.mongo.client.model.FindOneAndReplaceOptions
-
public class FindOneAndReplaceOptions extends java.lang.Object
The options to apply to an operation that atomically finds a document and replaces it.- Since:
- 3.0
- MongoDB documentation
- reference/command/findAndModify/
-
-
Constructor Summary
Constructors Constructor Description FindOneAndReplaceOptions()
FindOneAndReplaceOptions(JsonObject json)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Collation
getCollation()
Returns the collation optionsJsonObject
getHint()
Returns the hint for which index to use.java.lang.String
getHintString()
Gets the hint string to apply.java.lang.Long
getMaxTime()
Gets the maximum execution time for the find one and replace operation.JsonObject
getProjection()
Gets a document describing the fields to return for all matching documents.ReturnDocument
getReturnDocument()
Gets theReturnDocument
value indicating whether to return the document before it was replaced or afterJsonObject
getSort()
Gets the sort criteria to apply to the query.java.lang.Boolean
isBypassDocumentValidation()
Gets the the bypass document level validation flagjava.lang.Boolean
isUpsert()
Returns true if a new document should be inserted if there are no matches to the query filter.FindOneAndReplaceOptions
setBypassDocumentValidation(java.lang.Boolean bypassDocumentValidation)
Sets the bypass document level validation flag.FindOneAndReplaceOptions
setCollation(Collation collation)
Sets the collation optionsFindOneAndReplaceOptions
setHint(JsonObject hint)
Sets the hint for which index to use.FindOneAndReplaceOptions
setHintString(java.lang.String hint)
Sets the hint to apply.FindOneAndReplaceOptions
setMaxTime(java.lang.Long maxTime)
Sets the maximum execution time on the server for this operation.FindOneAndReplaceOptions
setProjection(JsonObject projection)
Sets a document describing the fields to return for all matching documents.FindOneAndReplaceOptions
setReturnDocument(ReturnDocument returnDocument)
Set whether to return the document before it was replaced or afterFindOneAndReplaceOptions
setSort(JsonObject sort)
Sets the sort criteria to apply to the query.FindOneAndReplaceOptions
setUpsert(java.lang.Boolean upsert)
Set to true if a new document should be inserted if there are no matches to the query filter.JsonObject
toJson()
-
-
-
Constructor Detail
-
FindOneAndReplaceOptions
public FindOneAndReplaceOptions()
-
FindOneAndReplaceOptions
public FindOneAndReplaceOptions(JsonObject json)
-
-
Method Detail
-
toJson
public JsonObject toJson()
-
setProjection
public FindOneAndReplaceOptions setProjection(JsonObject projection)
Sets a document describing the fields to return for all matching documents.- Parameters:
projection
- the project document, which may be null.- Returns:
- this
- MongoDB documentation
- Projection
-
getProjection
public JsonObject getProjection()
Gets a document describing the fields to return for all matching documents.- Returns:
- the project document, which may be null
- MongoDB documentation
- Projection
-
setSort
public FindOneAndReplaceOptions setSort(JsonObject sort)
Sets the sort criteria to apply to the query.- Parameters:
sort
- the sort criteria, which may be null.- Returns:
- this
- MongoDB documentation
- Sort
-
getSort
public JsonObject getSort()
Gets the sort criteria to apply to the query. The default is null, which means that the documents will be returned in an undefined order.- Returns:
- a document describing the sort criteria
- MongoDB documentation
- Sort
-
setUpsert
public FindOneAndReplaceOptions setUpsert(java.lang.Boolean upsert)
Set to true if a new document should be inserted if there are no matches to the query filter.- Parameters:
upsert
- true if a new document should be inserted if there are no matches to the query filter- Returns:
- this
-
isUpsert
public java.lang.Boolean isUpsert()
Returns true if a new document should be inserted if there are no matches to the query filter. The default is false.- Returns:
- true if a new document should be inserted if there are no matches to the query filter
-
setReturnDocument
public FindOneAndReplaceOptions setReturnDocument(ReturnDocument returnDocument)
Set whether to return the document before it was replaced or after- Parameters:
returnDocument
- set whether to return the document before it was replaced or after- Returns:
- this
-
getReturnDocument
public ReturnDocument getReturnDocument()
Gets theReturnDocument
value indicating whether to return the document before it was replaced or after- Returns:
ReturnDocument.BEFORE
if returning the document before it was replaced otherwise returnReturnDocument.AFTER
-
setMaxTime
public FindOneAndReplaceOptions setMaxTime(java.lang.Long maxTime)
Sets the maximum execution time on the server for this operation.- Parameters:
maxTime
- the max time (in milliseconds)- Returns:
- this
-
getMaxTime
public java.lang.Long getMaxTime()
Gets the maximum execution time for the find one and replace operation.- Returns:
- the max time
-
setBypassDocumentValidation
public FindOneAndReplaceOptions setBypassDocumentValidation(java.lang.Boolean bypassDocumentValidation)
Sets the bypass document level validation flag.- Parameters:
bypassDocumentValidation
- If true, allows the write to opt-out of document level validation.- Returns:
- this
- Since:
- 3.2
- Since server release
- 3.2
-
isBypassDocumentValidation
public java.lang.Boolean isBypassDocumentValidation()
Gets the the bypass document level validation flag- Returns:
- the bypass document level validation flag
- Since:
- 3.2
- Since server release
- 3.2
-
setCollation
public FindOneAndReplaceOptions setCollation(Collation collation)
Sets the collation optionsA null value represents the server default.
- Parameters:
collation
- the collation options to use- Returns:
- this
- Since:
- 3.4
- Since server release
- 3.4
-
getCollation
public Collation getCollation()
Returns the collation options- Returns:
- the collation options
- Since:
- 3.4
- Since server release
- 3.4
-
setHint
public FindOneAndReplaceOptions setHint(JsonObject hint)
Sets the hint for which index to use. A null value means no hint is set.- Parameters:
hint
- the hint- Returns:
- this
- Since:
- 4.1
-
getHint
public JsonObject getHint()
Returns the hint for which index to use. The default is not to set a hint.- Returns:
- the hint
- Since:
- 4.1
-
setHintString
public FindOneAndReplaceOptions setHintString(java.lang.String hint)
Sets the hint to apply.- Parameters:
hint
- the name of the index which should be used for the operation- Returns:
- this
- Since:
- 4.1
-
getHintString
public java.lang.String getHintString()
Gets the hint string to apply.- Returns:
- the hint string, which should be the name of an existing index
- Since:
- 4.1
-
-