Package io.vertx.mongo.client.model
Class FindOneAndReplaceOptions
- java.lang.Object
-
- io.vertx.mongo.client.model.FindOneAndReplaceOptions
-
public class FindOneAndReplaceOptions extends java.lang.ObjectThe 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 CollationgetCollation()Returns the collation optionsJsonObjectgetHint()Returns the hint for which index to use.java.lang.StringgetHintString()Gets the hint string to apply.java.lang.LonggetMaxTime()Gets the maximum execution time for the find one and replace operation.JsonObjectgetProjection()Gets a document describing the fields to return for all matching documents.ReturnDocumentgetReturnDocument()Gets theReturnDocumentvalue indicating whether to return the document before it was replaced or afterJsonObjectgetSort()Gets the sort criteria to apply to the query.java.lang.BooleanisBypassDocumentValidation()Gets the the bypass document level validation flagjava.lang.BooleanisUpsert()Returns true if a new document should be inserted if there are no matches to the query filter.FindOneAndReplaceOptionssetBypassDocumentValidation(java.lang.Boolean bypassDocumentValidation)Sets the bypass document level validation flag.FindOneAndReplaceOptionssetCollation(Collation collation)Sets the collation optionsFindOneAndReplaceOptionssetHint(JsonObject hint)Sets the hint for which index to use.FindOneAndReplaceOptionssetHintString(java.lang.String hint)Sets the hint to apply.FindOneAndReplaceOptionssetMaxTime(java.lang.Long maxTime)Sets the maximum execution time on the server for this operation.FindOneAndReplaceOptionssetProjection(JsonObject projection)Sets a document describing the fields to return for all matching documents.FindOneAndReplaceOptionssetReturnDocument(ReturnDocument returnDocument)Set whether to return the document before it was replaced or afterFindOneAndReplaceOptionssetSort(JsonObject sort)Sets the sort criteria to apply to the query.FindOneAndReplaceOptionssetUpsert(java.lang.Boolean upsert)Set to true if a new document should be inserted if there are no matches to the query filter.JsonObjecttoJson()
-
-
-
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 theReturnDocumentvalue indicating whether to return the document before it was replaced or after- Returns:
ReturnDocument.BEFOREif 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
-
-