C++ BSON使用

C++ BSON 主要类

使用C++ BSON 主要会接触到以下4个类：

  • bson::BSONObj：创建 BSONObj 对象。

  • bson::BSONElement：BSONObj对象由 BSONElement 对象组成，即 BSONElement 对象为 BSONObj 对象的字段或者元素，它是键值对。

  • bson::BSONObjBuilder：BSONObjBuilder 用来实例化 BSONObj 对象。

  • bson::BSONObjlterator：BSONObjlterator 用来遍历 BSONObj 对象中的元素。

命名空间 bson 中定义了这些类的类型为：

  • typedef bson::BSONElement be;

  • typedef bson::BSONObj bo;

  • typedef bson::BSONObjBuilder bob;

此外，还可以使用 BASE64C API 和 FROMJSON API来帮助构建C++ BSON。

建立对象

以下简单介绍如何创建 CPP BSON 实例。详细内容请查阅 C++ BSON API

  • 使用 BSONObject，BSONObjBuilder 建立对象
  1. #include "client.hpp"
  2.  
  3. using namespace bson ;
  4. BSONObj obj ;
  5. BSONObjBuilder b ;
  6.  
  7. b.append("name","sam") ;
  8. b.append("age","24") ;
  9. obj = b.obj() ;
  10. 或者
  11. obj = BSONObjBuilder().genOID().append("name","sam").append("age",24).obj() ;

另外，可以使用数据流的方法建立 BSONObj 对象。

  1. BSONObj obj ;
  2. BSONObjBuilder b ;
  3. b << "name" << "sam" << "age" << "24" ;
  4. obj = b.obj() ;
  • 使用宏 BSON 建立对象

C++ BSON 中定义还定义了一个 BSON 的宏，可以用它来快速地建立 BSONObj 对象。

  1. BSONObj obj ;
  2. // int
  3. obj = BSON( "a" << 1 ) ;
  4. // float
  5. obj = BSON( "b" << 3.14159265359 ) ;
  6. // string
  7. obj = BSON( "foo" << "bar" ) ;
  8. // OID
  9. obj = BSON( GENOID ) ;
  10. // bool
  11. obj = BSON( "flag" << true << "ret" << false ) ;
  12. // object
  13. obj = BSON( "d" << BSON("e" << "hi!") ) ;
  14. // array
  15. obj = BSON( "phone" << BSON_ARRAY( "13800138123" << "13800138124" ) ) ;
  16. // others, less then, greater then, etc
  17. obj = BSON( "g" << LT << 99 ) ;
  • 使用 fromjson 接口建立对象

此外，可以使用 fromjson.hpp 中的 fromjson() 将 json 字符串转换成 BSONObj 对象。

  1. string s("{name:\"sam\"}") ;
  2. fromjson ( s, obj ) ;
  3. 或者
  4. const char *r ="{ \
  5.                    firstName:\"Sam\", \
  6.                    lastName:\"Smith\",age:25,id:\"count\", \
  7.                    address:{streetAddress: \"25 3ndStreet\", \
  8.                    city:\"NewYork\",state:\"NY\",postalCode:\"10021\"}, \
  9.                    phoneNumber:[{\"type\": \"home\",number:\"212555-1234\"}] \
  10.                 }" ;
  11. fromjson ( r, obj ) ;