forked from mongodb/mongo-csharp-driver
/
Release Notes v1.0.txt
144 lines (104 loc) · 4.26 KB
/
Release Notes v1.0.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
C# Driver Version 1.0 Release Notes
Summary:
Added doc comments
Added help file generated from doc comments
Added IPv6 support (use ipv6=true in connection string)
Added support for the BSON undefined value
Setup (.msi file) now installs assemblies into the GAC
Strongly named assemblies
Support for new MongoDB 1.8 features
Unit tests all pass on Mono
UnregisterXyz methods removed
Breaking changes:
The namespaces have been changed for some of the serialization classes. You will need to
adjust your using statements accordingly.
The MongoDB.Bson.DefaultSerializer namespace has been removed and the classes in it have
been put in one of the following namespaces:
MongoDB.Bson.Serialization
MongoDB.Bson.Serialization.Attributes
MongoDB.Bson.Serialization.Conventions
MongoDB.Bson.Serialization.IdGenerators
MongoDB.Bson.Serialization.Options
MongoDB.Bson.Serialization.Serializers
Some methods have also been removed (e.g. Wrap and UnregisterXyz)
BSON Library changes:
BsonBuffer
MaxChunkPoolSize is now configurable
BsonDefaultSerializer
Much faster initialization (no longer uses reflection)
BsonDocument
New constructor with Hashtable parameter
New Add method with Hashtable parameter
New overload of Merge method with overwriteExistingElements parameter
BsonSerializer
RegisterSerializationProvider now adds new provider to a list
(so you can supplement the default provider without having to completely replace it)
BsonUndefined
New singleton class representing the BSON undefined value
DateTimeSerializer
String representation reimplemented to work around bugs in Mono
DateTimeSerializationOptions
Class is now immutable
DateOnlyInstance, LocalInstance and UtcInstance predefined instances added
JsonReader
Can now read multiple JSON documents from the same stream
JsonScanner
Added support for NumberLong
NamedIdMemberConvention
Now supports a list of possible Id member names instead of just one
The default instance now recognizes "Id", "id" and "_id" as the Id member
StringSerializer
New external representations: ObjectId, Symbol
Can use string in data model and ObjectId in data base
so data model does not have a dependency on the driver
Miscellaneous
Removed all UnregisterXyz methods
Removed Xyz.Wrap methods (can use XyzWrapper.Create instead, but you probably
shouldn't be using Wrappers anyway)
Driver changes:
CollectionOptions builder
Creates options used when creating a collection
FindAndModifyResult
Renamed GetModifiedDocument<T> to GetModifiedDocumentAs<T>
IndexCache
Used by EnsureIndex to track which indexes have already been created
Now maintained at server level
IndexOptions builder
Added support for sparse option
MapReduceOutput
New class to represent the different output options for MapReduce
(Inline, Merge, Reduce, Replace)
MapReduceResult
Added GetInlineResultsAs
Added GetResults (works with either inline or collection output)
Added GetResultsAs (works with either inline or collection output)
MongoCollection
EnsureIndex now uses the IndexCache in MongoServer
Save method now requires that document have an identifiable Id member
MongoConnectionPool
A few properties have been made public so your code can monitor the status of the pool
Added AvailableConnectionsCount property
Added CurrentPoolSize property
Made EndPoint property public
Made Server property public
MongoCursor
New overload of SetHint with indexName parameter
MongoDatabase
New CreateCollectionSettings method
New ResetIndexCache method (resets just the part of the cache related to this database)
MongoDBRef
Id property is now of type BsonValue (was object)
MongoServer
Added ConnectionPool property
Added CreateDatabaseSettings method
Added DatabaseExists method
Added GetAdminDatabase methods
Added IndexCache property
Added ResetIndexCache method
Added SecondaryConnectionPools property
Update builder
Added BitwiseAnd and BitwiseOr
Wrapper classes
Have been moved to the MongoDB.Driver.Wrappers namespace
(they are rarely needed by end users)
Have also removed Xyz.Wrap methods (to avoid encouraging their use when not appropriate)