// Copyright (C) MongoDB, Inc. 2017-present. // // Licensed under the Apache License, Version 2.0 (the "License"); you may // not use this file except in compliance with the License. You may obtain // a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 package options // ReplaceOptions represents options that can be used to configure a ReplaceOne operation. type ReplaceOptions struct { // If true, writes executed as part of the operation will opt out of document-level validation on the server. This // option is valid for MongoDB versions >= 3.2 and is ignored for previous server versions. The default value is // false. See https://docs.mongodb.com/manual/core/schema-validation/ for more information about document // validation. BypassDocumentValidation *bool // Specifies a collation to use for string comparisons during the operation. This option is only valid for MongoDB // versions >= 3.4. For previous server versions, the driver will return an error if this option is used. The // default value is nil, which means the default collation of the collection will be used. Collation *Collation // If true, a new document will be inserted if the filter does not match any documents in the collection. The // default value is false. Upsert *bool } // Replace creates a new ReplaceOptions instance. func Replace() *ReplaceOptions { return &ReplaceOptions{} } // SetBypassDocumentValidation sets the value for the BypassDocumentValidation field. func (ro *ReplaceOptions) SetBypassDocumentValidation(b bool) *ReplaceOptions { ro.BypassDocumentValidation = &b return ro } // SetCollation sets the value for the Collation field. func (ro *ReplaceOptions) SetCollation(c *Collation) *ReplaceOptions { ro.Collation = c return ro } // SetUpsert sets the value for the Upsert field. func (ro *ReplaceOptions) SetUpsert(b bool) *ReplaceOptions { ro.Upsert = &b return ro } // MergeReplaceOptions combines the given ReplaceOptions instances into a single ReplaceOptions in a last-one-wins // fashion. func MergeReplaceOptions(opts ...*ReplaceOptions) *ReplaceOptions { rOpts := Replace() for _, ro := range opts { if ro == nil { continue } if ro.BypassDocumentValidation != nil { rOpts.BypassDocumentValidation = ro.BypassDocumentValidation } if ro.Collation != nil { rOpts.Collation = ro.Collation } if ro.Upsert != nil { rOpts.Upsert = ro.Upsert } } return rOpts }