wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
202 lines
6.9 KiB
Markdown
202 lines
6.9 KiB
Markdown
# MongoDB C Driver History
|
|
|
|
## 0.6
|
|
2012-6-3
|
|
** API CHANGE **
|
|
|
|
Version 0.6 supports write concern. This involves a backward-breaking
|
|
API change, as the write functions now take an optional write_concern
|
|
object.
|
|
|
|
The driver now also supports the MONGO_CONTINUE_ON_ERROR flag for
|
|
batch inserts.
|
|
|
|
The new function prototypes are as follows:
|
|
|
|
* int mongo_insert( mongo *conn, const char *ns, const bson *data,
|
|
mongo_write_concern *custom_write_concern );
|
|
|
|
* int mongo_insert_batch( mongo *conn, const char *ns,
|
|
const bson **data, int num, mongo_write_concern *custom_write_concern );
|
|
|
|
* int mongo_update( mongo *conn, const char *ns, const bson *cond,
|
|
const bson *op, int flags, mongo_write_concern *custom_write_concern,
|
|
int flags );
|
|
|
|
* int mongo_remove( mongo *conn, const char *ns, const bson *cond,
|
|
mongo_write_concern *custom_write_concern );
|
|
|
|
* Allow DBRefs (i.e., allows keys $ref, $id, and $db)
|
|
* Added mongo_create_capped_collection().
|
|
* Fixed some bugs in the SCons and Makefile build scripts.
|
|
* Fixes for SCons and Makefile shared library install targets.
|
|
* Other minor bug fixes.
|
|
|
|
## 0.5.2
|
|
2012-5-4
|
|
|
|
* Validate collection and database names on insert.
|
|
* Validate insert limits using max BSON size.
|
|
* Support getaddrinfo and SO_RCVTIMEO and SO_SNDTIMEO on Windows.
|
|
* Store errno/WSAGetLastError() on errors.
|
|
* Various bug fixes and refactorings.
|
|
* Update error reporting docs.
|
|
|
|
## 0.5.1
|
|
|
|
* Env for POSIX, WIN32, and standard C.
|
|
* Various bug fixes.
|
|
|
|
## 0.5
|
|
2012-3-31
|
|
|
|
* Separate cursor-specific errors into their own enum: mongo_cursor_error_t.
|
|
* Catch $err return on bad queries and store the result in conn->getlasterrorcode
|
|
and conn->getlasterrstr.
|
|
* On queries that return $err, set cursor->err to MONGO_CURSOR_QUERY_FAIL.
|
|
* When passing bad BSON to a cursor object, set cursor->err to MONGO_CURSOR_BSON_ERROR,
|
|
and store the specific BSON error on the conn->err field.
|
|
* Remove bson_copy_basic().
|
|
* bson_copy() will copy finished bson objects only.
|
|
* bson_copy() returns BSON_OK on success and BSON_ERROR on failure.
|
|
* Added a Makefile for easy compile and install on Linux and OS X.
|
|
* Replica set connect fixes.
|
|
|
|
## 0.4
|
|
|
|
THIS RELEASE INCLUDES NUMEROUS BACKWARD-BREAKING CHANGES.
|
|
These changes have been made for extensibility, consistency,
|
|
and ease of use. Please read the following release notes
|
|
carefully, and study the updated tutorial.
|
|
|
|
API Principles:
|
|
|
|
1. Present a consistent interface for all objects: connections,
|
|
cursors, bson objects, and bson iterators.
|
|
2. Require no knowledge of an object's implementation to use the API.
|
|
3. Allow users to allocate objects on the stack or on the heap.
|
|
4. Integrate API with new error reporting strategy.
|
|
5. Be concise, except where it impairs clarity.
|
|
|
|
Changes:
|
|
|
|
* mongo_replset_init_conn has been renamed to mongo_replset_init.
|
|
* bson_buffer has been removed. All functions for building bson
|
|
objects now take objects of type bson. The new pattern looks like this:
|
|
|
|
Example:
|
|
|
|
bson b[1];
|
|
bson_init( b );
|
|
bson_append_int( b, "foo", 1 );
|
|
bson_finish( b );
|
|
/* The object is ready to use.
|
|
When finished, destroy it. */
|
|
bson_destroy( b );
|
|
|
|
* mongo_connection has been renamed to mongo.
|
|
|
|
Example:
|
|
|
|
mongo conn[1];
|
|
mongo_connect( conn, '127.0.0.1', 27017 );
|
|
/* Connection is ready. Destroy when down. */
|
|
mongo_destroy( conn );
|
|
|
|
* New cursor builder API for clearer code:
|
|
|
|
Example:
|
|
|
|
mongo_cursor cursor[1];
|
|
mongo_cursor_init( cursor, conn, "test.foo" );
|
|
|
|
bson query[1];
|
|
|
|
bson_init( query );
|
|
bson_append_int( query, "bar", 1 );
|
|
bson_finish( query );
|
|
|
|
bson fields[1];
|
|
|
|
bson_init( fields );
|
|
bson_append_int( fields, "baz", 1 );
|
|
bson_finish( fields );
|
|
|
|
mongo_cursor_set_query( cursor, query );
|
|
mongo_cursor_set_fields( cursor, fields );
|
|
mongo_cursor_set_limit( cursor, 10 );
|
|
mongo_cursor_set_skip( cursor, 10 );
|
|
|
|
while( mongo_cursor_next( cursor ) == MONGO_OK )
|
|
bson_print( mongo_cursor_bson( cursor ) );
|
|
|
|
* bson_iterator_init now takes a (bson*) instead of a (const char*). This is consistent
|
|
with bson_find, which also takes a (bson*). If you want to initiate a bson iterator
|
|
with a buffer, use the new function bson_iterator_from_buffer.
|
|
* With the addition of the mongo_cursor_bson function, it's now no
|
|
longer necessary to know how bson and mongo_cursor objects are implemented.
|
|
|
|
Example:
|
|
|
|
bson b[1];
|
|
bson_iterator i[1];
|
|
|
|
bson_iterator_init( i, b );
|
|
|
|
/* With a cursor */
|
|
bson_iterator_init( i, mongo_cursor_bson( cursor ) );
|
|
|
|
* Added mongo_cursor_data and bson_data functions, which return the
|
|
raw bson buffer as a (const char *).
|
|
* All constants that were once lower case are now
|
|
upper case. These include: MONGO_OP_MSG, MONGO_OP_UPDATE, MONGO_OP_INSERT,
|
|
MONGO_OP_QUERY, MONGO_OP_GET_MORE, MONGO_OP_DELETE, MONGO_OP_KILL_CURSORS
|
|
BSON_EOO, BSON_DOUBLE, BSON_STRING, BSON_OBJECT, BSON_ARRAY, BSON_BINDATA,
|
|
BSON_UNDEFINED, BSON_OID, BSON_BOOL, BSON_DATE, BSON_NULL, BSON_REGEX, BSON_DBREF,
|
|
BSON_CODE, BSON_SYMBOL, BSON_CODEWSCOPE, BSON_INT, BSON_TIMESTAMP, BSON_LONG,
|
|
MONGO_CONN_SUCCESS, MONGO_CONN_BAD_ARG, MONGO_CONN_NO_SOCKET, MONGO_CONN_FAIL,
|
|
MONGO_CONN_NOT_MASTER, MONGO_CONN_BAD_SET_NAME, MONGO_CONN_CANNOT_FIND_PRIMARY
|
|
If your programs use any of these constants, you must convert them to their
|
|
upper case forms, or you will see compile errors.
|
|
* The error handling strategy has been changed. Exceptions are not longer being used.
|
|
* Functions taking a mongo_connection object now return either MONGO_OK or MONGO_ERROR.
|
|
In case of an error, an error code of type mongo_error_t will be indicated on the
|
|
mongo_connection->err field.
|
|
* Functions taking a bson object now return either BSON_OK or BSON_ERROR.
|
|
In case of an error, an error code of type bson_validity_t will be indicated on the
|
|
bson->err or bson_buffer->err field.
|
|
* Calls to mongo_cmd_get_last_error store the error status on the
|
|
mongo->lasterrcode and mongo->lasterrstr fields.
|
|
* bson_print now prints all types.
|
|
* Users may now set custom malloc, realloc, free, printf, sprintf, and fprintf fields.
|
|
* Groundwork for modules for supporting platform-specific features (e.g., socket timeouts).
|
|
* Added mongo_set_op_timeout for setting socket timeout. To take advantage of this, you must
|
|
compile with --use-platform=LINUX. The compiles with platform/linux/net.h instead of the
|
|
top-level net.h.
|
|
* Fixed tailable cursors.
|
|
* GridFS API is now in-line with the new driver API. In particular, all of the
|
|
following functions now return MONGO_OK or MONGO_ERROR: gridfs_init,
|
|
gridfile_init, gridfile_writer_done, gridfs_store_buffer, gridfs_store_file,
|
|
and gridfs_find_query.
|
|
* Fixed a few memory leaks.
|
|
|
|
## 0.3
|
|
2011-4-14
|
|
|
|
* Support replica sets.
|
|
* Better standard connection API.
|
|
* GridFS write buffers iteratively.
|
|
* Fixes for working with large GridFS files (> 3GB)
|
|
* bson_append_string_n and family (Gergely Nagy)
|
|
|
|
## 0.2
|
|
2011-2-11
|
|
|
|
* GridFS support (Chris Triolo).
|
|
* BSON Timestamp type support.
|
|
|
|
## 0.1
|
|
2009-11-30
|
|
|
|
* Initial release.
|