libmongoc 1.17.4 » API参考

实现usr增删改查

用户信息增删改查

功能实现步骤:

1. 搭建网站服务器, 实现客户端与服务端的通信
2. 连接数据库, 创建用户集合, 向集合中插入文档
3. 当用户访问/list时, 将所有用户信息查询出来将用户信息和表格HTML进行拼接并将拼接结果响应客户端
   • 实现路由功能
   • 呈现用户列表页面
   • 从数据库中查询用户信息, 将用户信息展示在列表中
4. 将用户信息和表格HTML进行拼接并将拼接结果响应客户端
5. 当用户访问/add时, 呈现表单页面, 并实现添加用户信息功能
6. 当用户访问/modify时, 呈现修改页面, 并实现次改用户信息功能当用户访问/delete时, 实现用户删除功能
   • 增加页面路由 呈现页面
     1. 在点击修改按钮的时候, 将用户ID传递到当前页面
     2. 从数据库中查询用户信息, 将用户信息展示到页面中
   • 实现用户修改功能
     1. 指定表单的提交地址以及请求方式
     2. 接受客户端传递过来的修改信息, 找到用户, 将用户信息更改为最新的
7. 当用户访问/delete时, 实现用户删除功能

1.mongoc_database_add_user（）

概要

bool
mongoc_database_add_user (mongoc_database_t *database,
                          const char *username,
                          const char *password,
                          const bson_t *roles,
                          const bson_t *custom_data,
                          bson_error_t *error);

参数

• database：一个mongoc_database_t。

• username：用户名。

• password：用户的明文密码。

• roles：bson_t角色的可选。

• custom_data：可选bson_t的额外数据。

• error：bson_error_t或的位置NULL。

此功能将创建一个新用户，可以访问database。

警告

 

没有TLS时不要调用此函数。

错误

错误通过error参数返回，并且可能包括套接字或其他服务器端故障。

返回

返回true是否成功添加了用户。返回false并设置error是否存在无效的参数或服务器或网络错误。

2.mongoc_database_remove_user（）

概要

bool
mongoc_database_remove_user (mongoc_database_t *database,
                             const char *username,
                             bson_error_t *error);

此函数username将从中删除名为的用户database。

参数

• database：一个mongoc_database_t。

• username：包含要删除的用户名的字符串。

• error：bson_error_t或的可选位置NULL。

错误

错误通过error参数传播。如果当前用户无权执行该命令，则可能包括套接字错误或其他错误。

返回

true如果成功，则返回。返回false并设置error是否存在无效的参数或服务器或网络错误。

3.mongoc_database_remove_all_users（）

概要

bool
mongoc_database_remove_all_users (mongoc_database_t *database,
                                  bson_error_t *error);

此功能将删除所有配置为访问的用户database。

参数

• database：一个mongoc_database_t。

• error：bson_error_t或的可选位置NULL。

错误

错误通过error参数传播。如果存在套接字错误或当前用户无权执行给定命令，则此操作可能会失败。

返回

true如果成功，则返回。返回false并设置error是否存在无效的参数或服务器或网络错误。

4.mongoc_database_destroy（）

概要

void
mongoc_database_destroy (mongoc_database_t *database);

释放与相关的所有资源database，包括释放结构。如果database为NULL，则不执行任何操作。

参数

• database：一个mongoc_database_t。

5.mongoc_database_get_name（）

概要

const char *
mongoc_database_get_name (mongoc_database_t *database);

获取数据库的名称。

参数

• database：一个mongoc_database_t。

返回

不应修改或释放的字符串。

6.mongoc_database_find_collections（）

概要

mongoc_cursor_t *
mongoc_database_find_collections (mongoc_database_t *database,
                                  const bson_t *filter,
                                  bson_error_t *error)
   BSON_GNUC_DEPRECATED_FOR (mongoc_database_find_collections_with_opts);

弃用

不建议使用此函数，并且不应在新代码中使用该函数。

请改用mongoc_database_find_collections_with_opts（）。

描述

获取包含文档的游标，每个文档对应于此数据库上的集合。

该功能被视为可重试的读取操作。在出现暂时性错误（网络错误，由于副本集故障转移导致的错误等）时，将安全地重试该操作一次。如果retryreadsURI中的false为假（请参阅mongoc_uri_t），则重试行为不适用。

参数

• database：一个mongoc_database_t。

• filter：服务器用于过滤返回的集合的匹配器。可能是NULL。

• error：bson_error_t或的可选位置NULL。

错误

错误通过error参数传播。

返回

每个结果对应于该数据库中服务器的集合表示形式的游标。

7.mongoc_collection_update（）

概要

bool
mongoc_collection_update (mongoc_collection_t *collection,
                          mongoc_update_flags_t flags,
                          const bson_t *selector,
                          const bson_t *update,
                          const mongoc_write_concern_t *write_concern,
                          bson_error_t *error);

参数

• collection：一个mongoc_collection_t。

• flags：按位或mongoc_update_flags_t。

• selector：bson_t包含查询以匹配要更新的文档的。

• update：bson_t包含要执行的更新的。如果使用管道更新，则为bson_t数组。

• write_concern：一个mongoc_write_concern_t。

• error：bson_error_t或的可选位置NULL。

描述

被mongoc_collection_update_one（），mongoc_collection_update_many（）和mongoc_collection_replace_one（）取代。

此功能将更新collection该匹配项中的文档selector。

默认情况下，仅更新单个文档。设置标志以MONGOC_UPDATE_MULTI_UPDATE更新多个文档。

错误

错误通过error参数传播。

返回

true如果成功，则返回。返回false并设置error是否存在无效的参数或服务器或网络错误。

写关注超时或写关注错误被视为失败。

 

8.bson_init（）

内容提要

void
bson_init (bson_t *b);

参数

• b：一个bson_t。

描述

所述bson_init（）函数应初始化一个bson_t被放置在堆栈中。这等效于将bson_t初始化为BSON_INITIALIZER。