107 lines
3.7 KiB
Go
107 lines
3.7 KiB
Go
// 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
|
|
|
|
import (
|
|
"time"
|
|
|
|
"go.mongodb.org/mongo-driver/mongo/readconcern"
|
|
"go.mongodb.org/mongo-driver/mongo/readpref"
|
|
"go.mongodb.org/mongo-driver/mongo/writeconcern"
|
|
)
|
|
|
|
// DefaultCausalConsistency is the default value for the CausalConsistency option.
|
|
var DefaultCausalConsistency = true
|
|
|
|
// SessionOptions represents options that can be used to configure a Session.
|
|
type SessionOptions struct {
|
|
// If true, causal consistency will be enabled for the session. The default value is true. See
|
|
// https://docs.mongodb.com/manual/core/read-isolation-consistency-recency/#sessions for more information.
|
|
CausalConsistency *bool
|
|
|
|
// The default read concern for transactions started in the session. The default value is nil, which means that
|
|
// the read concern of the client used to start the session will be used.
|
|
DefaultReadConcern *readconcern.ReadConcern
|
|
|
|
// The default read preference for transactions started in the session. The default value is nil, which means that
|
|
// the read preference of the client used to start the session will be used.
|
|
DefaultReadPreference *readpref.ReadPref
|
|
|
|
// The default write concern for transactions started in the session. The default value is nil, which means that
|
|
// the write concern of the client used to start the session will be used.
|
|
DefaultWriteConcern *writeconcern.WriteConcern
|
|
|
|
// The default maximum amount of time that a CommitTransaction operation executed in the session can run on the
|
|
// server. The default value is nil, which means that that there is no time limit for execution.
|
|
DefaultMaxCommitTime *time.Duration
|
|
}
|
|
|
|
// Session creates a new SessionOptions instance.
|
|
func Session() *SessionOptions {
|
|
return &SessionOptions{
|
|
CausalConsistency: &DefaultCausalConsistency,
|
|
}
|
|
}
|
|
|
|
// SetCausalConsistency sets the value for the CausalConsistency field.
|
|
func (s *SessionOptions) SetCausalConsistency(b bool) *SessionOptions {
|
|
s.CausalConsistency = &b
|
|
return s
|
|
}
|
|
|
|
// SetDefaultReadConcern sets the value for the DefaultReadConcern field.
|
|
func (s *SessionOptions) SetDefaultReadConcern(rc *readconcern.ReadConcern) *SessionOptions {
|
|
s.DefaultReadConcern = rc
|
|
return s
|
|
}
|
|
|
|
// SetDefaultReadPreference sets the value for the DefaultReadPreference field.
|
|
func (s *SessionOptions) SetDefaultReadPreference(rp *readpref.ReadPref) *SessionOptions {
|
|
s.DefaultReadPreference = rp
|
|
return s
|
|
}
|
|
|
|
// SetDefaultWriteConcern sets the value for the DefaultWriteConcern field.
|
|
func (s *SessionOptions) SetDefaultWriteConcern(wc *writeconcern.WriteConcern) *SessionOptions {
|
|
s.DefaultWriteConcern = wc
|
|
return s
|
|
}
|
|
|
|
// SetDefaultMaxCommitTime sets the value for the DefaultMaxCommitTime field.
|
|
func (s *SessionOptions) SetDefaultMaxCommitTime(mct *time.Duration) *SessionOptions {
|
|
s.DefaultMaxCommitTime = mct
|
|
return s
|
|
}
|
|
|
|
// MergeSessionOptions combines the given SessionOptions instances into a single SessionOptions in a last-one-wins
|
|
// fashion.
|
|
func MergeSessionOptions(opts ...*SessionOptions) *SessionOptions {
|
|
s := Session()
|
|
for _, opt := range opts {
|
|
if opt == nil {
|
|
continue
|
|
}
|
|
if opt.CausalConsistency != nil {
|
|
s.CausalConsistency = opt.CausalConsistency
|
|
}
|
|
if opt.DefaultReadConcern != nil {
|
|
s.DefaultReadConcern = opt.DefaultReadConcern
|
|
}
|
|
if opt.DefaultReadPreference != nil {
|
|
s.DefaultReadPreference = opt.DefaultReadPreference
|
|
}
|
|
if opt.DefaultWriteConcern != nil {
|
|
s.DefaultWriteConcern = opt.DefaultWriteConcern
|
|
}
|
|
if opt.DefaultMaxCommitTime != nil {
|
|
s.DefaultMaxCommitTime = opt.DefaultMaxCommitTime
|
|
}
|
|
}
|
|
|
|
return s
|
|
}
|