RobotFramework自动化测试框架-MongoDBLibrary库的使用

笔者接着 RobotFramework自动化测试框架-DatabaseLibrary库的使用(对数据库的操作)

继续分享robotframework 对数据库中的MongoDB的详细操作。这是笔者第二篇关于robotframework 对数据库的操作的分享介绍。

MongoDB是非常常用的一个非关系型数据库，在RobotFramework中，也提供了对MongoDB数据库测试操作的支持。我们可以通过在浏览器中访问github的网站地址

https://github.com/iPlantCollaborativeOpenSource/Robotframework-MongoDB-Library 即可以看到该库的相关安装说明和API介绍，如下图2-2-1所示。

图2-2-1

作者的原创文章，转载须注明出处。原创文章归作者所有，欢迎转载，但是保留版权。对于转载了博主的原创文章，不标注出处的，作者将依法追究版权，请尊重作者的成果，转载请注明链接：https://www.cnblogs.com/laoqing/p/11509042.html

。

安装完成后，在使用MongoDBLibrary库时，需要在测试套件中，预先导入该库，才可以在用例中使用MongoDBLibrary库中的关键字，如下图2-2-2所示。

图2-2-2

2.1.1 MongoDB数据库的连接和断开

这六个参数，dbHost参数指的是MongoDB数据库的IP地址，dbPort参数指的是MongoDB数据库的端口号，不输入时默认为27017，dbMaxPoolSize参数指的是数据库连接的最大线程池大小，不输入时默认大小为10。

示例1：我们连接到本地电脑上一个已经启动好的MongoDB数据库上，这里预先启动了一个3.2版本的MongoDB数据库，如下图2-2-3所示。

图2-2-3

在RIDE中，使用Connect To Mongodb来连接刚刚启动好的数据库，如下图2-2-4所示。

图2-2-4

运行结果如下：

Starting test: RobotFrameworkTest1.TestSute13.TestCase001

20180825 17:47:32.470 : INFO :

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | <type ‘dict‘> | False |

Ending test: RobotFrameworkTest1.TestSute13.TestCase001

我们执行完成后，然后我看下MongoDB服务端的日志，从如下的MongoDB服务端的日志可以看到，已经成功和MongoDB数据库建立了连接。

2018-08-25T17:45:30.134+0800 I CONTROL [main] Hotfix KB2731284 or later update is not installed, will zero-out data files

2018-08-25T17:45:30.138+0800 I CONTROL [initandlisten] MongoDB starting : pid=8964 port=27017 dbpath=D:\MongoDB\Server\3.2\data 64-bit host=yongqing-PC

2018-08-25T17:45:30.138+0800 I CONTROL [initandlisten] targetMinOS: Windows Vista/Windows Server 2008

2018-08-25T17:45:30.139+0800 I CONTROL [initandlisten] db version v3.2.4

2018-08-25T17:45:30.139+0800 I CONTROL [initandlisten] git version: e2ee9ffcf9f5a94fad76802e28cc978718bb7a30

2018-08-25T17:45:30.140+0800 I CONTROL [initandlisten] allocator: tcmalloc

2018-08-25T17:45:30.140+0800 I CONTROL [initandlisten] modules: none

2018-08-25T17:45:30.140+0800 I CONTROL [initandlisten] build environment:

2018-08-25T17:45:30.161+0800 I CONTROL [initandlisten] distarch: x86_64

2018-08-25T17:45:30.162+0800 I CONTROL [initandlisten] target_arch: x86_64

2018-08-25T17:45:30.162+0800 I CONTROL [initandlisten] options: { storage: { dbPath: "D:\MongoDB\Server\3.2\data" }, systemLog: { destination: "file", path: "D:\MongoDB\Server\3.2\logs\log.log" } }

2018-08-25T17:45:30.164+0800 I STORAGE [initandlisten] wiredtiger_open config: create,cache_size=4G,session_max=20000,eviction=(threads_max=4),config_base=false,statistics=(fast),log=(enabled=true,archive=true,path=journal,compressor=snappy),file_manager=(close_idle_time=100000),checkpoint=(wait=60,log_size=2GB),statistics_log=(wait=0),

2018-08-25T17:45:31.202+0800 I FTDC [initandlisten] Initializing full-time diagnostic data capture with directory ‘D:/MongoDB/Server/3.2/data/diagnostic.data‘

2018-08-25T17:45:31.202+0800 I NETWORK [HostnameCanonicalizationWorker] Starting hostname canonicalization worker

2018-08-25T17:45:31.359+0800 I NETWORK [initandlisten] waiting for connections on port 27017

2018-08-25T17:46:53.205+0800 I NETWORK [initandlisten] connection accepted from 127.0.0.1:2621 #1 (1 connection now open)

2018-08-25T17:46:53.730+0800 I NETWORK [conn1] end connection 127.0.0.1:2621 (0 connections now open)

2018-08-25T17:47:32.471+0800 I NETWORK [initandlisten] connection accepted from 127.0.0.1:2650 #2 (1 connection now open)

2018-08-25T17:47:33.031+0800 I NETWORK [conn2] end connection 127.0.0.1:2650 (0 connections now open)

在MongoDB Libra中通过Disconnect From Mongodb 关键字来断开已经建立的MongoDB数据库连接。

示例2：通过Disconnect From Mongodb关键字断开MongoDB的数据库连接，如下图2-2-5所示。

图2-2-5

运行结果如下：

Starting test: RobotFrameworkTest1.TestSute13.TestCase001

20180825 17:57:04.680 : INFO :

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | <type ‘dict‘> | False |

20180825 17:57:04.684 : INFO : | Disconnect From MongoDB |

Ending test: RobotFrameworkTest1.TestSute13.TestCase001

从MongoDB的日志可以看到，在执行Disconnect From Mongodb关键字操作后，数据库服务端日志中已经显示数据库连接已经终止。

[conn3] end connection 127.0.0.1:2945 (0 connections now open)

2.1.2 Get Mongodb Databases和Get Mongodb Collections

在MongoDB Libray中通过Get Mongodb Databases关键字来获取当前MongoDB下的所有在用的数据库。

示例1：我们通过Get Mongodb Databases关键字来获取我们上面自己启动的MongoDB下的所有数据库，如下图2-2-6所示。

图2-2-6

运行结果如下：

Starting test: RobotFrameworkTest1.TestSute13.TestCase003

20180825 21:55:34.867 : INFO :

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | <type ‘dict‘> | False |

20180825 21:55:34.873 : INFO : | @{allDBs} | Get Mongodb Databases |

20180825 21:55:34.873 : INFO : @{DBs} = [ local ]

20180825 21:55:34.875 : INFO : local

20180825 21:55:34.877 : INFO : | Disconnect From MongoDB |

Ending test: RobotFrameworkTest1.TestSute13.TestCase003

从运行结果可以看到只获取到了一个名叫local的数据库，我们通过客户端连接到MongoDB服务端，然后执行show databases命令，可以看到得到的结果和我们通过 Get Mongodb Databases关键字来获取到的数据库信

息是一致的，如下图2-2-7所示。

图2-2-7

通过Get Mongodb Collections关键字可以获取到指定MongoDB数据库下的所有Collection，该关键字接收[ dbName ]一个参数。

示例2：我们通过Get Mongodb Collections关键字来获取到local库下的所有Collection，如下图2-2-8所示。

图2-2-8

运行结果如下：

Starting test: RobotFrameworkTest1.TestSute13.TestCase002

20180825 22:03:31.189 : INFO :

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | <type ‘dict‘> | False |

20180825 22:03:31.197 : INFO : | @{allDBs} | Get Mongodb Databases |

20180825 22:03:31.198 : INFO : @{DBs} = [ local ]

20180825 22:03:31.200 : INFO : local

20180825 22:03:31.205 : INFO : | @{allCollections} | Get MongoDB Collections | local |

20180825 22:03:31.206 : INFO : @{allCollections} = [ startup_log ]

20180825 22:03:31.208 : INFO : startup_log

20180825 22:03:31.210 : INFO : | Disconnect From MongoDB |

Ending test: RobotFrameworkTest1.TestSute13.TestCase002

从运行结果可以看到，获取到了local库下的Collection名叫startup_log，然后我们通过客户端连接到服务端后，通过客户端show collections命令来获取一下Collection，如下图所示，我们可以看到获取到的Collection是完

全一致的，如下图2-2-9所示。

图2-2-9

2.1.3 Save Mongodb Records

Save MongoDB Records关键字用来向指定的Collection中保存插入的记录，该关键字接收[ dbName | dbCollName | recordJSON ]这三个参数。

示例：我们向startup_log这个Collection中插入一条记录，如下图2-2-10所示。

图2-2-10

运行结果如下：

Starting test: RobotFrameworkTest1.TestSute13.TestCase004

20180825 22:16:34.333 : INFO :

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | <type ‘dict‘> | False |

20180825 22:16:34.344 : INFO : | ${allResults} | Save MongoDB Records | local | startup_log | {u‘book‘: u‘RobotFramework‘, ‘_id‘: ObjectId(‘5b8164c2685b132ec4739503‘)} |

20180825 22:16:34.347 : INFO : | Disconnect From MongoDB |

Ending test: RobotFrameworkTest1.TestSute13.TestCase004

执行完成后，我们通过MongoDB客户端连接到服务端，执行db.startup_log.find()命令来查看startup_log这个Collection下的记录，如下图所示，可以看到{"book":"RobotFramework"}这条数据记录已经成功插入到了

MongoDB中，如下图2-2-11所示。

图2-2-11

2.1.4 Retrieve All Mongodb Records

Retrieve All Mongodb Records关键字用来获取指定Collection下的所有数据记录，该关键字接收[ dbName | dbCollName | returnDocuments=False ]这三个参数。

示例：我们通过Retrieve All Mongodb Records关键字来获取startup_log下的数据记录，如下图2-2-12所示。

图2-2-12

运行结果如下：

Starting test: RobotFrameworkTest1.TestSute13.TestCase005

20180825 22:38:05.197 : INFO :

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | <type ‘dict‘> | False |

20180825 22:38:05.213 : INFO : ${allResults} = [{u‘hostname‘: u‘yongqing-PC‘, u‘pid‘: 8964L, u‘startTimeLocal‘: u‘Sat Aug 25 17:45:31.203‘, u‘cmdLine‘: {u‘storage‘: {u‘dbPath‘: u‘D:\\MongoDB\\Server\\3.2\\data‘}, u‘systemLog‘: {u‘path‘: u‘D:\\Mong...

20180825 22:38:05.215 : INFO : [{u‘hostname‘: u‘yongqing-PC‘, u‘pid‘: 8964L, u‘startTimeLocal‘: u‘Sat Aug 25 17:45:31.203‘, u‘cmdLine‘: {u‘storage‘: {u‘dbPath‘: u‘D:\\MongoDB\\Server\\3.2\\data‘}, u‘systemLog‘: {u‘path‘: u‘D:\\MongoDB\\Server\\3.2\\logs\\log.log‘, u‘destination‘: u‘file‘}}, u‘startTime‘: datetime.datetime(2018, 8, 25, 9, 45, 31), u‘_id‘: u‘yongqing-PC-1535190331203‘, u‘buildinfo‘: {u‘storageEngines‘: [u‘devnull‘, u‘ephemeralForTest‘, u‘mmapv1‘, u‘wiredTiger‘], u‘maxBsonObjectSize‘: 16777216, u‘bits‘: 64, u‘sysInfo‘: u‘deprecated‘, u‘modules‘: [], u‘openssl‘: {u‘compiled‘: u‘disabled‘, u‘running‘: u‘disabled‘}, u‘javascriptEngine‘: u‘mozjs‘, u‘version‘: u‘3.2.4‘, u‘gitVersion‘: u‘e2ee9ffcf9f5a94fad76802e28cc978718bb7a30‘, u‘versionArray‘: [3, 2, 4, 0], u‘debug‘: False, u‘buildEnvironment‘: {u‘cxxflags‘: u‘/TP‘, u‘cc‘: u‘cl: Microsoft (R) C/C++ Optimizing Compiler Version 18.00.31101 for x64‘, u‘linkflags‘: u‘/nologo /DEBUG /INCREMENTAL:NO /LARGEADDRESSAWARE /OPT:REF‘, u‘distarch‘: u‘x86_64‘, u‘cxx‘: u‘cl: Microsoft (R) C/C++ Optimizing Compiler Version 18.00.31101 for x64‘, u‘ccflags‘: u‘/nologo /EHsc /W3 /wd4355 /wd4800 /wd4267 /wd4244 /wd4290 /wd4068 /wd4351 /we4013 /we4099 /we4930 /Z7 /errorReport:none /MT /O2 /Oy- /Gw /Gy /Zc:inline‘, u‘target_arch‘: u‘x86_64‘, u‘distmod‘: u‘‘, u‘target_os‘: u‘windows‘}, u‘targetMinOS‘: u‘Windows Vista/Windows Server 2008‘, u‘allocator‘: u‘tcmalloc‘}}, {u‘_id‘: ObjectId(‘5b8164c2685b132ec4739503‘), u‘book‘: u‘RobotFramework‘}]

20180825 22:38:05.217 : INFO : | Disconnect From MongoDB |

Ending test: RobotFrameworkTest1.TestSute13.TestCase005

如下图2-2-13所示，运行结果与我们在客户端通过db.startup_log.find()命令行获取到结果是一致的。

图2-2-13

2.1.5 Update Many Mongodb Records

Update Many Mongodb Records关键字用来更新Collection中的数据记录，该关键字接收[ dbName | dbCollName | queryJSON | updateJSON | upsert=False ]这五个参数。

示例1：我们更新上面示例中插入的这条{"book":"RobotFramework"}记录为{"book":"robotFramework"}，即将RobotFramework变为robotFramework，如下图2-2-14所示。

图2-2-14

运行结果如下：

Starting test: RobotFrameworkTest1.TestSute13.TestCase006

20180825 23:05:53.692 : INFO :

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | <type ‘dict‘> | False |

20180825 23:05:53.700 : INFO : ${newJson} = {"$set": {"book":"robotFramework"}}

20180825 23:05:53.708 : INFO :

Matched: 1 documents

| ${allResults} | Update Many MongoDB Records | local | startup_log | {u‘book‘: u‘RobotFramework‘} | {u‘$set‘: {u‘book‘: u‘robotFramework‘}} |

20180825 23:05:53.710 : INFO : | Disconnect From MongoDB |

Ending test: RobotFrameworkTest1.TestSute13.TestCase006

更新完成后，我们通过客户端的db.startup_log.find()命令行来进行重新查询，如下图2-2-15所示，从查询的结果可以看到指定的记录已经更新完成了。

图2-2-15

2.1.6 Remove Mongodb Records

Remove Mongodb Records关键字用来删除指定Collection中的数据记录，该关键字接收[ dbName | dbCollName | recordJSON ]这三个参数。

示例：我们重新创建一个capped属性为false的Collection，因为之前的Collection的capped属性为true，会导致数据记录无法被删除，客户端创建一个Collection的命令为db.createCollection("RobotFramework",{capped :

false})，如下图2-2-16所示新的名叫RobotFramework的Collection的已经创建完成。

图2-2-16

如下图2-2-17所示，创建完成后，我们使用Remove Mongodb Records关键字来删除{"book":"robotFramework"}这条记录，如下图2-2-18所示。

图2-2-17

图2-2-18

运行结果如下：

Starting test: RobotFrameworkTest1.TestSute13.TestCase007

20180826 09:40:05.945 : INFO :

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | <type ‘dict‘> | False |

20180826 09:40:05.947 : INFO : ${Json} = {"book":"RobotFramework"}

20180826 09:40:05.970 : INFO : | ${allResults} | Remove MongoDB Records | local | RobotFramework | {u‘book‘: u‘RobotFramework‘} |

20180826 09:40:05.972 : INFO : | Disconnect From MongoDB |

Ending test: RobotFrameworkTest1.TestSute13.TestCase007

执行完成后，我们在客户端执行db.RobotFramework.find()进行查询时，如下图2-2-19所示，从查询的结果可以看到{"book":"robotFramework"}这条记录已经被删除了

图2-2-19

2.1.7 MongoDB Libray库的其它关键字介绍

下表2-2-1中介绍了MongoDBLibrary库中其它关键字的使用示例

关键字

使用描述

Drop Mongodb Database

该关键字用来删除指定的MongoDB数据库，接收[ dbDelName ]一个参数，示例：

Drop Mongodb Database

Local

Drop Mongodb Collection

该关键字用来删除指定的Collection，接收[ dbName | dbCollName ]两个参数，示例：

Drop Mongodb Collection

local

RobotFramework

Get Mongodb Collection Count

该关键字用来获取指定Collection下的数据记录总数，接收[ dbName | dbCollName ]两个参数，示例：

${counts}	Get Mongodb Collection Count	local	RobotFramework
log	${counts}

Retrieve And Update One Mongodb Record

该关键字用来获取并且更新指定的数据记录，关键字接收[ dbName | dbCollName | queryJSON | updateJSON | returnBeforeDocument=False ]这五个参数，示例：

${queryJson}	Set Variable	{"book":"RobotFramework"}
${newJson}	Set Variable	{"$set": {"book":"robotFramework"}}
Retrieve and Update One Mongodb Record	local	RobotFramework	${queryJson}	${newJson}