MongoDB是非常常用的一个非关系型数据库。Robot Framework提供了对MongoDB数据库测试操作的支持。我们可以通过在浏览器中访问GitHub的网站地址https://github.com/iPlant CollaborativeOpenSource/Robotframework-MongoDB-Library,查看该库的相关安装说明和API介绍,如图2-2-1所示。
图 2-2-1
安装完成后,在使用MongoDBLibrary库时,需要预先在测试套件中导入该库,如图2-2-2所示。
图 2-2-2
在MongoDBLibrary中通过Connect To MongoDB关键字来连接到MongoDB数据库,该关键字接收[ dbHost=localhost | dbPort=27017 | dbMaxPoolSize=10 | dbNetworkTimeout=None | dbDocClass= | dbTZAware=False ]六个参数。其中,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
运行结果如图2-2-5所示。
图 2-2-5
执行完成后,查看一下MongoDB服务端的日志。从如图2-2-6所示的MongoDB服务端的日志可以看到,已经成功和MongoDB数据库建立了连接。
图 2-2-6
在MongoDBLibrary中通过Disconnect From Mongodb关键字来断开已经建立的MongoDB数据库连接。
【示例2】通过Disconnect From Mongodb关键字断开MongoDB的数据库连接,如图2-2-7所示。
图 2-2-7
运行结果如图2-2-8所示。
图 2-2-8
从MongoDB的日志可以看到,在执行Disconnect From Mongodb关键字操作后,数据库服务端日志中已经显示数据库连接终止。
[conn3] end connection 127.0.0.1:2945 (0 connections now open)
在MongoDBLibrary中通过Get Mongodb Databases关键字来获取当前MongoDB下所有在用的数据库。
【示例1】我们通过Get Mongodb Databases关键字来获取上面启动的MongoDB下的所有数据库,如图2-2-9所示。
图 2-2-9
运行结果如图2-2-10所示。
图 2-2-10
从运行结果可以看到只获取到了一个名叫local的数据库。我们通过客户端连接到MongoDB服务端,然后执行show databases命令,可以看到得到的结果和我们通过Get Mongodb Databases关键字来获取到的数据库信息是一致的,如图2-2-11所示。
图 2-2-11
通过Get Mongodb Collections关键字可以获取到指定MongoDB数据库下的所有Collection,该关键字接收[ dbName ]一个参数。
【示例2】我们通过Get Mongodb Collections关键字来获取到local库下的所有Collection,如图2-2-12所示。
图 2-2-12
运行结果如图2-2-13所示。
图 2-2-13
从运行结果可以看到,获取到的local库下的Collection名叫startup_log,然后我们通过客户端连接到服务端,通过客户端show collections命令来获取Collection。我们可以看到获取到的Collection是完全一致的,如图2-2-14所示。
图 2-2-14
Save MongoDB Records关键字用来向指定的Collection中保存插入的记录,接收[ dbName| dbCollName | recordJSON ]三个参数。
【示例】我们向startup_log这个Collection中插入一条记录,如图2-2-15所示。
图 2-2-15
运行结果如图2-2-16所示。
图 2-2-16
执行完成后,我们通过MongoDB客户端连接到服务端,执行db.startup_log.find()命令来查看startup_log这个Collection下的记录。可以看到{"book":"RobotFramework"}这条数据记录已经成功插入MongoDB中,如图2-2-17所示。
图 2-2-17
Retrieve All Mongodb Records关键字用来获取指定Collection下的所有数据记录,接收[ dbName | dbCollName | returnDocuments=False ]三个参数。
【示例】我们通过Retrieve All Mongodb Records关键字来获取startup_log下的数据记录,如图2-2-18所示。
图 2-2-18
运行结果如图2-2-19所示。
图 2-2-19
如图2-2-20所示,运行结果与我们在客户端通过db.startup_log.find()命令行获取到的结果是一致的。
图 2-2-20
Update Many Mongodb Records关键字用来更新Collection中的数据记录,接收[ dbName | dbCollName | queryJSON | updateJSON | upsert=False ]五个参数。
【示例】我们更新上面示例中插入的{"book":"RobotFramework"}记录为{"book":"robotFramework"},即将RobotFramework变为robotFramework,如图2-2-21所示。
图 2-2-21
运行结果如图2-2-22所示。
图 2-2-22
更新完成后,通过客户端的db.startup_log.find()命令来进行重新查询,如图2-2-23所示。从查询的结果可以看到指定的记录已经更新完成了。
图 2-2-23
Remove Mongodb Records关键字用来删除指定Collection中的数据记录,接收[ dbName | dbCollName | recordJSON ]三个参数。
【示例】我们重新创建一个capped属性为false的Collection,因为之前的Collection的capped属性为true,会导致数据记录无法被删除。在客户端创建一个Collection的命令为db.createCollection("RobotFramework",{capped : false}),如图2-2-24所示,新的名叫RobotFramework的Collection创建完成。
图 2-2-24
创建完成后,通过客户端的db.Robot Framework.find()命令进行查询,如图2-2-25所示。然后我们使用Remove Mongodb Records关键字来删除{"book":"robotFramework"}这条记录,如图2-2-26所示。
图 2-2-25
图 2-2-26
运行结果如图2-2-27所示。
图 2-2-27
执行完成后,在客户端执行db.RobotFramework.find()进行查询,如图2-2-28所示,从查询的结果可以看到{"book":"robotFramework"}这条记录已经被删除。
图 2-2-28
表2-2-1中列出了MongoDBLibrary库中其他关键字的使用示例。
表2-2-1 MongoDBLibrary库中其他关键字