bson

type Binary ¶

type Binary struct {
	Kind byte
	Data []byte
}

Binary is a representation for non-standard binary values. Any kind should work, but the following are known as of this writing:

0x00 - Generic. This is decoded as []byte(data), not Binary{0x00, data}.
0x01 - Function (!?)
0x02 - Obsolete generic.
0x03 - UUID
0x05 - MD5
0x80 - User defined.

type D ¶

type D []DocElem

D represents a BSON document containing ordered elements. For example:

bson.D{{"a", 1}, {"b", true}}

In some situations, such as when creating indexes for MongoDB, the order in which the elements are defined is important. If the order is not important, using a map is generally more comfortable. See bson.M and bson.RawD.

func (d D) Map() (m M)

type DocElem ¶

type DocElem struct {
	Name  string
	Value interface{}
}

See the D type.

type Getter ¶

type Getter interface {
	GetBSON() (interface{}, error)
}

A value implementing the bson.Getter interface will have its GetBSON method called when the given value has to be marshalled, and the result of this method will be marshaled in place of the actual object.

If GetBSON returns return a non-nil error, the marshalling procedure will stop and error out with the provided value.

type JavaScript ¶

type JavaScript struct {
	Code  string
	Scope interface{}
}

JavaScript is a type that holds JavaScript code. If Scope is non-nil, it will be marshaled as a mapping from identifiers to values that may be used when evaluating the provided Code.

type M ¶

type M map[string]interface{}

M is a convenient alias for a map[string]interface{} map, useful for dealing with BSON in a native way. For instance:

bson.M{"a": 1, "b": true}

There's no special handling for this type in addition to what's done anyway for an equivalent map type. Elements in the map will be dumped in an undefined ordered. See also the bson.D type for an ordered alternative.

type MongoTimestamp ¶

type MongoTimestamp int64

MongoTimestamp is a special internal type used by MongoDB that for some strange reason has its own datatype defined in BSON.

type ObjectId ¶

type ObjectId string

ObjectId is a unique ID identifying a BSON value. It must be exactly 12 bytes long. MongoDB objects by default have such a property set in their "_id" property.

http://www.mongodb.org/display/DOCS/Object+IDs

func NewObjectId() ObjectId

func NewObjectIdWithTime(t time.Time) ObjectId

func ObjectIdHex(s string) ObjectId

func (id ObjectId) Counter() int32

func (id ObjectId) Hex() string

func (id ObjectId) Machine() []byte

func (id ObjectId) MarshalJSON() ([]byte, error)

func (id ObjectId) Pid() uint16

func (id ObjectId) String() string

func (id ObjectId) Time() time.Time

func (id *ObjectId) UnmarshalJSON(data []byte) error

func (id ObjectId) Valid() bool

type Raw ¶

type Raw struct {
	Kind byte
	Data []byte
}

The Raw type represents raw unprocessed BSON documents and elements. Kind is the kind of element as defined per the BSON specification, and Data is the raw unprocessed data for the respective element. Using this type it is possible to unmarshal or marshal values partially.

Relevant documentation:

http://bsonspec.org/#/specification

func (raw Raw) Unmarshal(out interface{}) (err error)

type RawD ¶

type RawD []RawDocElem

RawD represents a BSON document containing raw unprocessed elements. This low-level representation may be useful when lazily processing documents of uncertain content, or when manipulating the raw content documents in general.

type RawDocElem ¶

type RawDocElem struct {
	Name  string
	Value Raw
}

See the RawD type.

type RegEx ¶

type RegEx struct {
	Pattern string
	Options string
}

RegEx represents a regular expression. The Options field may contain individual characters defining the way in which the pattern should be applied, and must be sorted. Valid options as of this writing are 'i' for case insensitive matching, 'm' for multi-line matching, 'x' for verbose mode, 'l' to make \w, \W, and similar be locale-dependent, 's' for dot-all mode (a '.' matches everything), and 'u' to make \w, \W, and similar match unicode. The value of the Options parameter is not verified before being marshaled into the BSON format.

type Setter ¶

type Setter interface {
	SetBSON(raw Raw) error
}

A value implementing the bson.Setter interface will receive the BSON value via the SetBSON method during unmarshaling, and the object itself will not be changed as usual.

If setting the value works, the method should return nil or alternatively bson.SetZero to set the respective field to its zero value (nil for pointer types). If SetBSON returns a value of type bson.TypeError, the BSON value will be omitted from a map or slice being decoded and the unmarshalling will continue. If it returns any other non-nil error, the unmarshalling procedure will stop and error out with the provided value.

This interface is generally useful in pointer receivers, since the method will want to change the receiver. A type field that implements the Setter interface doesn't have to be a pointer, though.

Unlike the usual behavior, unmarshalling onto a value that implements a Setter interface will NOT reset the value to its zero state. This allows the value to decide by itself how to be unmarshalled.

For example:

type MyString string

func (s *MyString) SetBSON(raw bson.Raw) error {
    return raw.Unmarshal(s)
}

type Symbol ¶

type Symbol string

The Symbol type is similar to a string and is used in languages with a distinct symbol type.

type TypeError ¶

type TypeError struct {
	Type reflect.Type
	Kind byte
}

func (e *TypeError) Error() string