Class FindOneAndUpdateOptions


  • public class FindOneAndUpdateOptions
    extends Object
    The options to apply to an operation that atomically finds a document and updates it.
    Since:
    3.0
    MongoDB documentation
    reference/command/findAndModify/
    • Constructor Detail

      • FindOneAndUpdateOptions

        public FindOneAndUpdateOptions()
    • Method Detail

      • getProjection

        @Nullable
        public Bson getProjection()
        Gets a document describing the fields to return for all matching documents.
        Returns:
        the project document, which may be null
        MongoDB documentation
        Projection
      • projection

        public FindOneAndUpdateOptions projection​(@Nullable
                                                  Bson 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
      • getSort

        @Nullable
        public Bson 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
      • sort

        public FindOneAndUpdateOptions sort​(@Nullable
                                            Bson sort)
        Sets the sort criteria to apply to the query.
        Parameters:
        sort - the sort criteria, which may be null.
        Returns:
        this
        MongoDB documentation
        Sort
      • isUpsert

        public 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
      • upsert

        public FindOneAndUpdateOptions upsert​(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
      • returnDocument

        public FindOneAndUpdateOptions returnDocument​(ReturnDocument returnDocument)
        Set whether to return the document before it was updated / inserted or after
        Parameters:
        returnDocument - set whether to return the document before it was updated / inserted or after
        Returns:
        this
      • maxTime

        public FindOneAndUpdateOptions maxTime​(long maxTime,
                                               TimeUnit timeUnit)
        Sets the maximum execution time on the server for this operation.
        Parameters:
        maxTime - the max time
        timeUnit - the time unit, which may not be null
        Returns:
        this
      • getMaxTime

        public long getMaxTime​(TimeUnit timeUnit)
        Gets the maximum execution time for the find one and update operation.
        Parameters:
        timeUnit - the time unit for the result
        Returns:
        the max time
      • getBypassDocumentValidation

        @Nullable
        public Boolean getBypassDocumentValidation()
        Gets the the bypass document level validation flag
        Returns:
        the bypass document level validation flag
        Since:
        3.2
        Since server release
        3.2
      • bypassDocumentValidation

        public FindOneAndUpdateOptions bypassDocumentValidation​(@Nullable
                                                                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
      • getCollation

        @Nullable
        public Collation getCollation()
        Returns the collation options
        Returns:
        the collation options
        Since:
        3.4
        Since server release
        3.4
      • collation

        public FindOneAndUpdateOptions collation​(@Nullable
                                                 Collation collation)
        Sets the collation options

        A null value represents the server default.

        Parameters:
        collation - the collation options to use
        Returns:
        this
        Since:
        3.4
        Since server release
        3.4
      • arrayFilters

        public FindOneAndUpdateOptions arrayFilters​(@Nullable
                                                    List<? extends Bson> arrayFilters)
        Sets the array filters option
        Parameters:
        arrayFilters - the array filters, which may be null
        Returns:
        this
        Since:
        3.6
        Since server release
        3.6
      • getArrayFilters

        @Nullable
        public List<? extends Bson> getArrayFilters()
        Returns the array filters option
        Returns:
        the array filters, which may be null
        Since:
        3.6
        Since server release
        3.6
      • getHint

        @Nullable
        public Bson getHint()
        Returns the hint for which index to use. The default is not to set a hint.
        Returns:
        the hint
        Since:
        4.1
      • hint

        public FindOneAndUpdateOptions hint​(@Nullable
                                            Bson 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
      • getHintString

        @Nullable
        public String getHintString()
        Gets the hint string to apply.
        Returns:
        the hint string, which should be the name of an existing index
        Since:
        4.1
      • hintString

        public FindOneAndUpdateOptions hintString​(@Nullable
                                                  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