// Copyright (C) MongoDB, Inc. 2019-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 // Code generated by operationgen. DO NOT EDIT. package operation import ( "context" "errors" "fmt" "go.mongodb.org/mongo-driver/event" "go.mongodb.org/mongo-driver/mongo/writeconcern" "go.mongodb.org/mongo-driver/x/bsonx/bsoncore" "go.mongodb.org/mongo-driver/x/mongo/driver" "go.mongodb.org/mongo-driver/x/mongo/driver/description" "go.mongodb.org/mongo-driver/x/mongo/driver/session" ) // Insert performs an insert operation. type Insert struct { bypassDocumentValidation *bool documents []bsoncore.Document ordered *bool session *session.Client clock *session.ClusterClock collection string monitor *event.CommandMonitor crypt *driver.Crypt database string deployment driver.Deployment selector description.ServerSelector writeConcern *writeconcern.WriteConcern retry *driver.RetryMode result InsertResult } type InsertResult struct { // Number of documents successfully inserted. N int32 } func buildInsertResult(response bsoncore.Document, srvr driver.Server) (InsertResult, error) { elements, err := response.Elements() if err != nil { return InsertResult{}, err } ir := InsertResult{} for _, element := range elements { switch element.Key() { case "n": var ok bool ir.N, ok = element.Value().AsInt32OK() if !ok { err = fmt.Errorf("response field 'n' is type int32, but received BSON type %s", element.Value().Type) } } } return ir, nil } // NewInsert constructs and returns a new Insert. func NewInsert(documents ...bsoncore.Document) *Insert { return &Insert{ documents: documents, } } // Result returns the result of executing this operation. func (i *Insert) Result() InsertResult { return i.result } func (i *Insert) processResponse(response bsoncore.Document, srvr driver.Server, desc description.Server) error { var err error i.result, err = buildInsertResult(response, srvr) return err } // Execute runs this operations and returns an error if the operaiton did not execute successfully. func (i *Insert) Execute(ctx context.Context) error { if i.deployment == nil { return errors.New("the Insert operation must have a Deployment set before Execute can be called") } batches := &driver.Batches{ Identifier: "documents", Documents: i.documents, Ordered: i.ordered, } return driver.Operation{ CommandFn: i.command, ProcessResponseFn: i.processResponse, Batches: batches, RetryMode: i.retry, Type: driver.Write, Client: i.session, Clock: i.clock, CommandMonitor: i.monitor, Crypt: i.crypt, Database: i.database, Deployment: i.deployment, Selector: i.selector, WriteConcern: i.writeConcern, }.Execute(ctx, nil) } func (i *Insert) command(dst []byte, desc description.SelectedServer) ([]byte, error) { dst = bsoncore.AppendStringElement(dst, "insert", i.collection) if i.bypassDocumentValidation != nil && (desc.WireVersion != nil && desc.WireVersion.Includes(4)) { dst = bsoncore.AppendBooleanElement(dst, "bypassDocumentValidation", *i.bypassDocumentValidation) } if i.ordered != nil { dst = bsoncore.AppendBooleanElement(dst, "ordered", *i.ordered) } return dst, nil } // BypassDocumentValidation allows the operation to opt-out of document level validation. Valid // for server versions >= 3.2. For servers < 3.2, this setting is ignored. func (i *Insert) BypassDocumentValidation(bypassDocumentValidation bool) *Insert { if i == nil { i = new(Insert) } i.bypassDocumentValidation = &bypassDocumentValidation return i } // Documents adds documents to this operation that will be inserted when this operation is // executed. func (i *Insert) Documents(documents ...bsoncore.Document) *Insert { if i == nil { i = new(Insert) } i.documents = documents return i } // Ordered sets ordered. If true, when a write fails, the operation will return the error, when // false write failures do not stop execution of the operation. func (i *Insert) Ordered(ordered bool) *Insert { if i == nil { i = new(Insert) } i.ordered = &ordered return i } // Session sets the session for this operation. func (i *Insert) Session(session *session.Client) *Insert { if i == nil { i = new(Insert) } i.session = session return i } // ClusterClock sets the cluster clock for this operation. func (i *Insert) ClusterClock(clock *session.ClusterClock) *Insert { if i == nil { i = new(Insert) } i.clock = clock return i } // Collection sets the collection that this command will run against. func (i *Insert) Collection(collection string) *Insert { if i == nil { i = new(Insert) } i.collection = collection return i } // CommandMonitor sets the monitor to use for APM events. func (i *Insert) CommandMonitor(monitor *event.CommandMonitor) *Insert { if i == nil { i = new(Insert) } i.monitor = monitor return i } // Crypt sets the Crypt object to use for automatic encryption and decryption. func (i *Insert) Crypt(crypt *driver.Crypt) *Insert { if i == nil { i = new(Insert) } i.crypt = crypt return i } // Database sets the database to run this operation against. func (i *Insert) Database(database string) *Insert { if i == nil { i = new(Insert) } i.database = database return i } // Deployment sets the deployment to use for this operation. func (i *Insert) Deployment(deployment driver.Deployment) *Insert { if i == nil { i = new(Insert) } i.deployment = deployment return i } // ServerSelector sets the selector used to retrieve a server. func (i *Insert) ServerSelector(selector description.ServerSelector) *Insert { if i == nil { i = new(Insert) } i.selector = selector return i } // WriteConcern sets the write concern for this operation. func (i *Insert) WriteConcern(writeConcern *writeconcern.WriteConcern) *Insert { if i == nil { i = new(Insert) } i.writeConcern = writeConcern return i } // Retry enables retryable mode for this operation. Retries are handled automatically in driver.Operation.Execute based // on how the operation is set. func (i *Insert) Retry(retry driver.RetryMode) *Insert { if i == nil { i = new(Insert) } i.retry = &retry return i }