79 lines
2.8 KiB
Go
79 lines
2.8 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"
|
||
|
|
|
||
|
|
// DistinctOptions represents options that can be used to configure a Distinct operation.
|
||
|
|
type DistinctOptions struct {
|
||
|
|
// 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
|
||
|
|
|
||
|
|
// A string or document that will be included in server logs, profiling logs, and currentOp queries to help trace
|
||
|
|
// the operation. The default value is nil, which means that no comment will be included in the logs.
|
||
|
|
Comment interface{}
|
||
|
|
|
||
|
|
// The maximum amount of time that the query can run on the server. The default value is nil, meaning that there
|
||
|
|
// is no time limit for query execution.
|
||
|
|
//
|
||
|
|
// NOTE(benjirewis): MaxTime will be deprecated in a future release. The more general Timeout option may be
|
||
|
|
// used in its place to control the amount of time that a single operation can run before returning an error.
|
||
|
|
// MaxTime is ignored if Timeout is set on the client.
|
||
|
|
MaxTime *time.Duration
|
||
|
|
}
|
||
|
|
|
||
|
|
// Distinct creates a new DistinctOptions instance.
|
||
|
|
func Distinct() *DistinctOptions {
|
||
|
|
return &DistinctOptions{}
|
||
|
|
}
|
||
|
|
|
||
|
|
// SetCollation sets the value for the Collation field.
|
||
|
|
func (do *DistinctOptions) SetCollation(c *Collation) *DistinctOptions {
|
||
|
|
do.Collation = c
|
||
|
|
return do
|
||
|
|
}
|
||
|
|
|
||
|
|
// SetComment sets the value for the Comment field.
|
||
|
|
func (do *DistinctOptions) SetComment(comment interface{}) *DistinctOptions {
|
||
|
|
do.Comment = comment
|
||
|
|
return do
|
||
|
|
}
|
||
|
|
|
||
|
|
// SetMaxTime sets the value for the MaxTime field.
|
||
|
|
//
|
||
|
|
// NOTE(benjirewis): MaxTime will be deprecated in a future release. The more general Timeout
|
||
|
|
// option may be used in its place to control the amount of time that a single operation can
|
||
|
|
// run before returning an error. MaxTime is ignored if Timeout is set on the client.
|
||
|
|
func (do *DistinctOptions) SetMaxTime(d time.Duration) *DistinctOptions {
|
||
|
|
do.MaxTime = &d
|
||
|
|
return do
|
||
|
|
}
|
||
|
|
|
||
|
|
// MergeDistinctOptions combines the given DistinctOptions instances into a single DistinctOptions in a last-one-wins
|
||
|
|
// fashion.
|
||
|
|
func MergeDistinctOptions(opts ...*DistinctOptions) *DistinctOptions {
|
||
|
|
distinctOpts := Distinct()
|
||
|
|
for _, do := range opts {
|
||
|
|
if do == nil {
|
||
|
|
continue
|
||
|
|
}
|
||
|
|
if do.Collation != nil {
|
||
|
|
distinctOpts.Collation = do.Collation
|
||
|
|
}
|
||
|
|
if do.Comment != nil {
|
||
|
|
distinctOpts.Comment = do.Comment
|
||
|
|
}
|
||
|
|
if do.MaxTime != nil {
|
||
|
|
distinctOpts.MaxTime = do.MaxTime
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
return distinctOpts
|
||
|
|
}
|