4.3OVSDB协议通信 OVSDB的协议与外界通信的方式，rpcmethod，在JSON-RPC 1.0中实现。协议中每一个request字符串包含了method的name、传递给这个method的参数（可以为null）、request id；每一个response字符串包含了result object（调用成功时为非null）、error object（出错时应该为非null）、匹配请求的id。该database的wire protocol的实现是基于TCP实现的，tcp的端口号为6640。OVSDB协议一般实现了如下的method：List Databases、Get Schema、Transact、Cancel、Monitor、Update Notification、Monitor Cancellation、Lock Operations、Locked Notification、Stolen Notification、Echo。 4.3.1 List Databases 该操作主要是检索那些元素是数据库名字的数组。 Request包含了如下成员： o “method”: “list_dbs” o “params”: [] o “id”: response包含了如下成员： o “result”: [,…] o “error”: null o “id”: same “id” as request 4.3.2 Get Schema 该操作主要是检索描述的。 Request包含了如下成员： o “method”: “get_schema” o “params”: [] o “id”: response包含了如下成员： o “result”: o “error”: null o “id”: same “id” as request 如果我们的request中的database name在database中不存在，那么server就会发送如下的error response： o “result”: null o “error”: “unknown database” o “id”: same “id” as request 4.3.3 Transact 该操作主要是促使database服务器去对指定的数据库执行一系列的操作。 Request包含了如下成员： o “method”: “transact” o “params”: [, ]（后续跟的operation，每一个operation代表了一次单一的数据库操作，如果一个操作失败了，那么后续的operation也不会被执行，只有所有的operation都执行成功，transaction才会被提交。这里的operation将会在后续的章节4.4中做详细说明） o “id”: response包含了如下成员： o “result”: [] o “error”: null o “id”: same “id” as request 4.3.4 Cancel 该操作是一个通知操作，且没有对应的response。它指示server端去做完成或者取消transact的request操作。 Notification包含了如下成员： o “method”: “cancel” o “params”: [the “id” for an outstanding request] o “id”: null 在执行上述notification的情况下，如果transact操作能够迅速完成，那么就会回应自己的response操作，如果未完成，那么server就会回应一个error response，该error response如下： o “result”: null o “error”: “canceled” o “id”: the “id” member of the canceled request. 4.3.5 Monitor 该monitor request包含了如下成员： o “method”: “monitor” o “params”: [, , ] o “id”: 该monitor response包含了如下成员： o “result”: o “error”: null o “id”: same “id” as request 4.3.6 Update Notification 该更新通知操作是由server发往client来通知表项的变化的，该response是对上述的monitor request的应答。 该notification包含了如下成员： o “method”: “update” o “params”: [, ] o “id”: null 该与上述monitor request中传递的相同，则为从表项名字到的映射，而则为从行的UUID到的映射，一个一般有如下成员： “old”: present for “delete” and “modify” updates “new”: present for “initial”, “insert”, and “modify” updates 由于它们之间的映射关系，各种改变也会在相应的对象中体现出来。 4.3.7 Monitor Cancellation 该操作的request是为了取消先前的monitor request。 该request包含了如下成员： o “method”: “monitor_cancel” o “params”: [] o “id”: 该与上述monitor request中传递的匹配，且是需要取消的monitor request。 该response包含了如下成员： o “result”: {} o “error”: null o “id”: the request “id” member 如果该monitor cancellation的request对应的一个无效的monitor request，那么就会返回一个错误的response如下： o “result”: null o “error”: “unknown monitor” o “id”: the request “id” member 4.3.8 Lock Operations 在OVSDB中提供了三个methods来支持clients对database的locking操作：“lock”、“steal"和"unlock”，这些由database提供的locks是由client定义的ID值来标识，且在任意时刻每个lock最多只能有一个拥有者，那么在众多clients中，它们只能允许一个拥有该lock的所有者读该database进行操作。 该request包含了如下成员： o “method”: “lock”, “steal”, or “unlock” o “params”: [] o “id”: 对应每个request，相应的response如下： o “result”: {“locked”: boolean} for “lock” o “result”: {“locked”: true} for “steal” o “result”: {} for “unlock” o “error”: null o “id”: same “id” as request 对于相应的操作，解释如下： Lock：当该lock可用的时候，database就会分配给请求的client该lock，如果有多个client请求同一个lock，它们采用先来先服务的顺序； Steal：database迅速分配给该client有steal请求的所有权，如果已经存在了所有者，那么之前的所有者丢掉该lock的所有权； Unlock：如果该client拥有该lock，那么这个操作会释放其拥有权； 注意：当关闭或者断开一个database client的连接的时候，会unlock其所有的lock； 4.3.9 Locked Notification 由于上面的request和response都是立即完成的，如果成功获得lock，其locked成员就是TRUE，否则就返回FALSE并放入队列中等待，该notification主要是用来通知client其之前请求的lock获得了允许，该notification有如下成员： o “method”: “locked” o “params”: [] o “id”: null 注意：database server会在回应了相应的lock request之后（该response中的locked成员必须为false）和回应client的一系列的unlock request之前； 4.3.10 Stolen Notification 该notification主要是用来通知一个client，其之前所拥有的lock，已经被其他client stolen，丢失了所有权。该notification有如下成员： o “method”: “stolen” o “params”: [] o “id”: null 注意：被通知的client不再拥有该lock，且该client要再后续执行lock或者steal则必须发布unlock的request；如果一个client以前就通过lock request拥有该lock，如果stole该lock的client释放了该lock，那么原client就自动重新获得该lock；而通过steal request获取lock的client则不会再重新获得可用的lock，但是要重新获的该lock必须unlock之后再lock； 4.3.11 Echo 该echo用于server和client证实其数据库连接是否保活，request成员如下： o “method”: “echo” o “params”: JSON array with any contents o “id”: response成员如下： o “result”: same as “params” o “error”: null o “id”: the request “id” member
