25개 이상의 토픽을 선택하실 수 없습니다. Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

929 lines
55 KiB

5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
5 년 전
  1. -module(agGeneralGraphs).
  2. -include("erlArango.hrl").
  3. -compile([export_all, nowarn_export_all]).
  4. %% doc_address:https://www.arangodb.com/docs/stable/http/gharial.html
  5. % 列出图形模块已知的所有图形。
  6. % GET /_api/gharial
  7. % 列出此数据库中存储的所有图形。
  8. % 如果模块可用并且可以列出图形,则返回HTTP 200。
  9. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  10. % code:响应代码。
  11. % 图表:
  12. % graph:有关新创建的图的信息
  13. % name:图形名称
  14. % edgeDefinitions:图形关系的定义数组。每个都有以下类型:
  15. % orphanCollections:其他顶点集合的数组。这些集合中的文档在此图中没有边。
  16. % numberOfShards:为图中的每个新集合创建的分片数。
  17. % _id:此图的内部ID值。
  18. % _rev:此图的修订版。可用于确保不覆盖对该图的并发修改。
  19. % ReplicationFactor:图形中每个新集合使用的复制因子。
  20. % isSmart:标记图形是否为SmartGraph(仅限企业版)。
  21. % smartGraphAttribute:智能图例中的分片属性名称(仅企业版)
  22. getGharialList(PoolNameOrSocket) ->
  23. agHttpCli:callAgency(PoolNameOrSocket, ?AgGet, <<"/_api/gharial">>, [], undefined).
  24. % 在图形模块中创建一个新图形。
  25. % POST /_api/gharial
  26. % 查询参数
  27. % waitForSync(可选):定义请求是否应该等待,直到所有内容都同步到光盘。将更改成功响应代码。
  28. % 具有以下属性的JSON对象是必需的:
  29. % name:图形名称。
  30. % edgeDefinitions:图形关系的定义数组。每个都有以下类型:
  31. % orphanCollections:其他顶点集合的数组。这些集合中的文档在此图中没有边。
  32. % isSmart:定义创建的图形是否应该是智能的。这仅在企业版中有效。
  33. % options:一个JSON对象,用于定义用于在此图中创建集合的选项。它可以包含以下属性:
  34. % smartGraphAttribute:仅在企业版中有效,如果isSmart为true,则为必需。用于聪明地分割图的顶点的属性名称。此SmartGraph中的每个顶点都必须具有此属性。以后无法修改。
  35. % numberOfShards:此图中每个集合使用的分片数。以后无法修改。
  36. % 复制因子:最初为此图创建集合时使用的复制因子。
  37. % writeConcern:对图中的新集合进行关注。它确定在不同的DBServer上同步每个分片需要多少个副本。如果集群中的副本数量很少,那么分片将拒绝写入。但是,具有足够最新副本的分片写入将同时成功。writeConcern的值 不能大于ReplicationFactor。(仅集群)
  38. % 图的创建需要图的名称和其边缘的定义。 另请参见边缘定义。
  39. % 如果可以创建图形并且为_graphs集合启用了waitForSync 或在请求中指定了图形,则返回HTTP 201。响应主体包含已存储的图形配置。
  40. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  41. % code:响应代码。
  42. % graph:有关新创建的图的信息。
  43. % 如果可以创建图形并且为该_graphs集合禁用了waitForSync,并且未在请求中给出,则返回HTTP 202。响应主体包含已存储的图形配置。
  44. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  45. % code:响应代码。
  46. % graph:有关新创建的图的信息。
  47. % HTTP 400如果请求的格式错误,则返回。
  48. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  49. % code:响应代码。
  50. % errorNum:发生错误的ArangoDB错误号。
  51. % errorMessage:为此错误创建的消息。
  52. % HTTP 403如果您的用户权限不足,则返回。为了创建图,您至少需要具有以下特权:
  53. % Administrate 访问数据库。
  54. % Read Only 访问此图中使用的每个集合。
  55. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  56. % code:响应代码。
  57. % errorNum:发生错误的ArangoDB错误号。
  58. % errorMessage:为此错误创建的消息。
  59. % HTTP 409如果存储图形时发生冲突,则返回。如果已经存储了具有该名称的图形,或者存在一个边缘定义具有相同的边缘集合但在任何其他图形中使用了不同的签名,则可能会发生这种情况 。
  60. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  61. % code:响应代码。
  62. % errorNum:发生错误的ArangoDB错误号。
  63. % errorMessage:为此错误创建的消息。
  64. newGharial(PoolNameOrSocket, MapData) ->
  65. BodyStr = jiffy:encode(MapData),
  66. agHttpCli:callAgency(PoolNameOrSocket, ?AgPost, <<"/_api/gharial">>, [], BodyStr).
  67. newGharial(PoolNameOrSocket, MapData, WaitForSync) ->
  68. Path =
  69. case WaitForSync of
  70. true ->
  71. <<"/_api/gharial?waitForSync=true">>;
  72. _ ->
  73. <<"/_api/gharial?waitForSync=false">>
  74. end,
  75. BodyStr = jiffy:encode(MapData),
  76. agHttpCli:callAgency(PoolNameOrSocket, ?AgPost, Path, [], BodyStr).
  77. % 获取图表
  78. % GET /_api/gharial/{graph}
  79. % 路径参数
  80. % 图(必填):图的名称。
  81. % 选择给定图的信息。将返回边缘定义以及孤立集合。或如果图形不存在,则返回404。
  82. % HTTP 200如果可以找到该图,则返回该图。结果将具有以下格式:
  83. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  84. % code:响应代码。
  85. % graph:有关新创建的图的信息
  86. % HTTP 404如果找不到具有该名称的图形,则返回。
  87. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  88. % code:响应代码。
  89. % errorNum:发生错误的ArangoDB错误号。
  90. % errorMessage:为此错误创建的消息。
  91. getGharial(PoolNameOrSocket, GraphName) ->
  92. Path = <<"/_api/gharial/", GraphName/binary>>,
  93. agHttpCli:callAgency(PoolNameOrSocket, ?AgGet, Path, [], undefined).
  94. % 删除现有图
  95. % DELETE /_api/gharial/{graph}
  96. % 路径参数
  97. % 图(必填):图的名称。
  98. % 查询参数
  99. % dropCollections(可选):也删除该图的集合。只有在其他图形中未使用集合时,集合才会被删除。
  100. % 按名称删除现有图形对象。(可选)也可以删除其他图未使用的所有集合。
  101. % 201:如果可以删除该图并为该_graphs集合启用了waitForSync ,或者在请求中给出了该图,则返回该值。
  102. % 202:如果可以删除该图并且为该_graphs集合禁用了waitForSync,并且未在请求中给出,则返回该值。
  103. % HTTP 403如果您的用户权限不足,则返回。为了删除图,您至少需要具有以下特权:
  104. % Administrate 访问数据库。
  105. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  106. % code:响应代码。
  107. % errorNum:发生错误的ArangoDB错误号。
  108. % errorMessage:为此错误创建的消息。
  109. % HTTP 404如果找不到具有该名称的图形,则返回。
  110. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  111. % code:响应代码。
  112. % errorNum:发生错误的ArangoDB错误号。
  113. % errorMessage:为此错误创建的消息。
  114. delGharial(PoolNameOrSocket, GraphName) ->
  115. Path = <<"/_api/gharial/", GraphName/binary>>,
  116. agHttpCli:callAgency(PoolNameOrSocket, ?AgDelete, Path, [], undefined).
  117. delGharial(PoolNameOrSocket, GraphName, DropCollections) ->
  118. Path =
  119. case DropCollections of
  120. true ->
  121. <<"/_api/gharial/", GraphName/binary, "?dropCollections=true">>;
  122. _ ->
  123. <<"/_api/gharial/", GraphName/binary, "?dropCollections=false">>
  124. end,
  125. agHttpCli:callAgency(PoolNameOrSocket, ?AgDelete, Path, [], undefined).
  126. % 列出此图中使用的所有顶点集合。
  127. % GET /_api/gharial/{graph}/vertex
  128. % 路径参数
  129. % 图(必填):图的名称。
  130. % 列出此图中的所有顶点集合。
  131. % 如果可以列出集合,则返回HTTP 200。
  132. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  133. % code:响应代码。
  134. % collections:此图中所有顶点集合的列表。在edgeDefinitions和孤儿中包括集合。
  135. % HTTP 404如果找不到具有该名称的图形,则返回。
  136. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  137. % code:响应代码。
  138. % errorNum:发生错误的ArangoDB错误号。
  139. % errorMessage:为此错误创建的消息。
  140. getGharialVertexCollList(PoolNameOrSocket, GraphName) ->
  141. Path = <<"/_api/gharial/", GraphName/binary, "/vertex">>,
  142. agHttpCli:callAgency(PoolNameOrSocket, ?AgGet, Path, [], undefined).
  143. % 向图中添加一个额外的顶点集合。
  144. % POST /_api/gharial/{graph}/vertex
  145. % 路径参数
  146. % 图(必填):图的名称。
  147. % 将顶点集合添加到图形的孤立集合中。如果该集合不存在,则将创建它。
  148. % 如果可以创建集合并为该_graphs集合启用waitForSync 或在请求中指定了HTTP,则返回HTTP 201。响应主体包含已存储的图形配置。
  149. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  150. % code:响应代码。
  151. % graph:有关修改后的图的信息。
  152. % 如果可以创建集合并且为该_graphs集合禁用了waitForSync 或在请求中指定了HTTP,则返回HTTP 202。响应主体包含已存储的图形配置。
  153. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  154. % code:响应代码。
  155. % graph:有关新创建的图的信息
  156. % HTTP 400如果请求的格式无效,则返回。
  157. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  158. % code:响应代码。
  159. % errorNum:发生错误的ArangoDB错误号。
  160. % errorMessage:为此错误创建的消息。
  161. % HTTP 403如果您的用户权限不足,则返回。为了修改图,您至少需要具有以下特权:
  162. % Administrate 访问数据库。
  163. % Read Only 访问此图中使用的每个集合。
  164. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  165. % code:响应代码。
  166. % errorNum:发生错误的ArangoDB错误号。
  167. % errorMessage:为此错误创建的消息。
  168. % HTTP 404如果找不到具有该名称的图形,则返回。
  169. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  170. % code:响应代码。
  171. % errorNum:发生错误的ArangoDB错误号。
  172. % errorMessage:为此错误创建的消息。
  173. %% MapData = #{"collection" => "otherVertices"}
  174. addGharialVertexColl(PoolNameOrSocket, GraphName, MapData) ->
  175. Path = <<"/_api/gharial/", GraphName/binary, "/vertex">>,
  176. BodyStr = jiffy:encode(MapData),
  177. agHttpCli:callAgency(PoolNameOrSocket, ?AgPost, Path, [], BodyStr).
  178. % 从图形中删除顶点集合。
  179. % DELETE /_api/gharial/{graph}/vertex/{collection}
  180. % 路径参数
  181. % 图(必填):图的名称。
  182. % 集合(必填):顶点集合的名称。
  183. % 查询参数
  184. % dropCollection(可选):也删除集合。只有在其他图形中未使用集合时,集合才会被删除。
  185. % 如果未在其他任何图中使用顶点集合,则从图中删除顶点集合,并有选择地删除该集合。如果边缘定义中不再使用这些顶点集合,则只能删除不再属于这些定义的顶点集合。
  186. % HTTP 200如果成功从图形中删除了顶点集合并且waitForSync为true,则返回。
  187. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  188. % code:响应代码。
  189. % graph:有关新创建的图的信息
  190. % HTTP 202如果请求成功,但waitForSync为false,则返回。
  191. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  192. % code:响应代码。
  193. % graph:有关新创建的图的信息
  194. % HTTP 400如果顶点集合仍在边缘定义中使用,则返回。在这种情况下,它仍不能从图形中删除,必须先从边定义中删除。
  195. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  196. % code:响应代码。
  197. % errorNum:发生错误的ArangoDB错误号。
  198. % errorMessage:为此错误创建的消息。
  199. % HTTP 403如果您的用户权限不足,则返回。为了删除顶点,您至少需要具有以下特权:
  200. % Administrate 访问数据库。
  201. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  202. % code:响应代码。
  203. % errorNum:发生错误的ArangoDB错误号。
  204. % errorMessage:为此错误创建的消息。
  205. % HTTP 404如果找不到具有该名称的图形,则返回。
  206. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  207. % code:响应代码。
  208. % errorNum:发生错误的ArangoDB错误号。
  209. % errorMessage:为此错误创建的消息。
  210. delGharialVertexColl(PoolNameOrSocket, GraphName, CollName) ->
  211. Path = <<"/_api/gharial/", GraphName/binary, "/vertex/", CollName/binary>>,
  212. agHttpCli:callAgency(PoolNameOrSocket, ?AgDelete, Path, [], undefined).
  213. delGharialVertexColl(PoolNameOrSocket, GraphName, CollName, DropCollection) ->
  214. Path =
  215. case DropCollection of
  216. true ->
  217. <<"/_api/gharial/", GraphName/binary, "/vertex/", CollName/binary, "?dropCollection=true">>;
  218. _ ->
  219. <<"/_api/gharial/", GraphName/binary, "/vertex/", CollName/binary, "?dropCollection=false">>
  220. end,
  221. agHttpCli:callAgency(PoolNameOrSocket, ?AgDelete, Path, [], undefined).
  222. % 列出所有边缘定义
  223. % GET /_api/gharial/{graph}/edge
  224. % 路径参数
  225. % 图(必填):图的名称。
  226. % 列出此图中的所有边集合。
  227. % 如果可以列出边缘定义,则返回HTTP 200。
  228. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  229. % code:响应代码。
  230. % collections:此图中所有顶点集合的列表。在edgeDefinitions和孤儿中包括集合。
  231. % HTTP 404如果找不到具有该名称的图形,则返回。
  232. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  233. % code:响应代码。
  234. % errorNum:发生错误的ArangoDB错误号。
  235. % errorMessage:为此错误创建的消息。
  236. getGharialEdgeDefList(PoolNameOrSocket, GraphName) ->
  237. Path = <<"/_api/gharial/", GraphName/binary, "/edge">>,
  238. agHttpCli:callAgency(PoolNameOrSocket, ?AgGet, Path, [], undefined).
  239. % 向图添加新的边定义
  240. % POST /_api/gharial/{graph}/edge
  241. % 路径参数
  242. % 图(必填):图的名称。
  243. % 具有以下属性的JSON对象是必需的:
  244. % collection:要使用的边缘集合的名称。
  245. % from:一个或多个可以包含源顶点的顶点集合。
  246. % to:一个或多个可以包含目标顶点的顶点集合。
  247. % 向图形添加其他边定义。
  248. % 这个边缘清晰度必须包含一个集合,并且每个的阵列从和到顶点集合。仅当未在任何其他图形中使用该定义或将其与完全相同的定义一起使用时,才可以添加边定义。在一个图中不可能存储从“ v1”到“ v2”的定义“ e”,而在另一张图中存储从“ v2”到“ v1”的定义“ e”。
  249. % HTTP 201如果可以成功添加定义并且为_graphs集合启用了waitForSync,则返回。响应主体包含已存储的图形配置。
  250. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  251. % code:响应代码。
  252. % graph:有关修改后的图的信息。
  253. % HTTP 202如果可以成功添加定义并且对该_graphs集合禁用了waitForSync,则返回。响应主体包含已存储的图形配置。
  254. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  255. % code:响应代码。
  256. % graph:有关修改后的图的信息。
  257. % HTTP 400如果无法添加定义,则返回。这可能是因为其格式错误,或者是在其他具有不同签名的图形中使用了该定义。
  258. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  259. % code:响应代码。
  260. % errorNum:发生错误的ArangoDB错误号。
  261. % errorMessage:为此错误创建的消息。
  262. % HTTP 403如果您的用户权限不足,则返回。为了修改图,您至少需要具有以下特权:
  263. % Administrate 访问数据库。
  264. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  265. % code:响应代码。
  266. % errorNum:发生错误的ArangoDB错误号。
  267. % errorMessage:为此错误创建的消息。
  268. % HTTP 404如果找不到具有该名称的图形,则返回。
  269. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  270. % code:响应代码。
  271. % errorNum:发生错误的ArangoDB错误号。
  272. % errorMessage:为此错误创建的消息。
  273. addGharialEdgeDef(PoolNameOrSocket, GraphName, MapData) ->
  274. Path = <<"/_api/gharial/", GraphName/binary, "/edge">>,
  275. BodyStr = jiffy:encode(MapData),
  276. agHttpCli:callAgency(PoolNameOrSocket, ?AgPost, Path, [], BodyStr).
  277. % 替换现有的边缘定义
  278. % PUT /_api/gharial/{graph}/edge/{definition}#definition
  279. % 路径参数
  280. % 图(必填):图的名称。
  281. % 定义(必填):定义中使用的边集合的名称。
  282. % 查询参数
  283. % waitForSync(可选):定义请求是否应等待直到同步到磁盘。
  284. % dropCollections(可选):也删除集合。只有在其他图形中未使用集合时,集合才会被删除。
  285. % 具有以下属性的JSON对象是必需的:
  286. % collection:要使用的边缘集合的名称。
  287. % from:一个或多个可以包含源顶点的顶点集合。
  288. % to:一个或多个可以包含目标顶点的顶点集合。
  289. % 更改一个特定的边定义。这将修改数据库中所有已知图中所有出现的该定义。
  290. % HTTP 201如果请求成功并且waitForSync为true,则返回。
  291. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  292. % code:响应代码。
  293. % graph:有关修改后的图的信息。
  294. % HTTP 202如果请求成功,但waitForSync为false,则返回。
  295. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  296. % code:响应代码。
  297. % graph:有关修改后的图的信息。
  298. % HTTP 400如果在图形中未找到具有此名称的边定义,或者新定义的格式不正确且无法使用,则返回。
  299. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  300. % code:响应代码。
  301. % errorNum:发生错误的ArangoDB错误号。
  302. % errorMessage:为此错误创建的消息。
  303. % HTTP 403如果您的用户权限不足,则返回。为了删除顶点,您至少需要具有以下特权:
  304. % Administrate 访问数据库。
  305. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  306. % code:响应代码。
  307. % errorNum:发生错误的ArangoDB错误号。
  308. % errorMessage:为此错误创建的消息。
  309. % HTTP 404如果找不到具有该名称的图形,则返回。
  310. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  311. % code:响应代码。
  312. % errorNum:发生错误的ArangoDB错误号。
  313. % errorMessage:为此错误创建的消息。
  314. replaceGharialEdgeDef(PoolNameOrSocket, GraphName, CollName, MapData) ->
  315. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary>>,
  316. BodyStr = jiffy:encode(MapData),
  317. agHttpCli:callAgency(PoolNameOrSocket, ?AgPut, Path, [], BodyStr).
  318. replaceGharialEdgeDef(PoolNameOrSocket, GraphName, CollName, MapData, QueryPars) ->
  319. QueryBinary = agMiscUtils:spellQueryPars(QueryPars),
  320. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary, QueryBinary/binary>>,
  321. BodyStr = jiffy:encode(MapData),
  322. agHttpCli:callAgency(PoolNameOrSocket, ?AgPut, Path, [], BodyStr).
  323. % 从图形中删除边缘定义
  324. % DELETE /_api/gharial/{graph}/edge/{definition}#definition
  325. % 路径参数
  326. % 图(必填):图的名称。
  327. % 定义(必填):定义中使用的边集合的名称。
  328. % 查询参数
  329. % waitForSync(可选):定义请求是否应等待直到同步到磁盘。
  330. % dropCollections(可选):也删除集合。只有在其他图形中未使用集合时,集合才会被删除。
  331. % 从图形中删除一个边缘定义。这只会删除边缘集合,顶点集合保持不变,并且仍可以在查询中使用。
  332. % HTTP 201如果可以从图形中删除边缘定义并且waitForSync为true,则返回。
  333. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  334. % code:响应代码。
  335. % graph:有关修改后的图的信息。
  336. % HTTP 202如果可以从图形中删除边缘定义并且waitForSync为false,则返回。
  337. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  338. % code:响应代码。
  339. % graph:有关修改后的图的信息。
  340. % HTTP 403如果您的用户权限不足,则返回。为了删除顶点,您至少需要具有以下特权:
  341. % Administrate 访问数据库。
  342. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  343. % code:响应代码。
  344. % errorNum:发生错误的ArangoDB错误号。
  345. % errorMessage:为此错误创建的消息。
  346. % HTTP 404如果找不到该名称的图形,或者在图形中找不到此名称的边定义,则返回。
  347. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  348. % code:响应代码。
  349. % errorNum:发生错误的ArangoDB错误号。
  350. % errorMessage:为此错误创建的消息。
  351. delGharialEdgeDef(PoolNameOrSocket, GraphName, CollName) ->
  352. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary>>,
  353. agHttpCli:callAgency(PoolNameOrSocket, ?AgDelete, Path, [], undefined).
  354. delGharialEdgeDef(PoolNameOrSocket, GraphName, CollName, QueryPars) ->
  355. QueryBinary = agMiscUtils:spellQueryPars(QueryPars),
  356. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary, QueryBinary/binary>>,
  357. agHttpCli:callAgency(PoolNameOrSocket, ?AgDelete, Path, [], undefined).
  358. % 创建一个新顶点
  359. % POST /_api/gharial/{graph}/vertex/{collection}
  360. % 路径参数
  361. % 图(必填):图的名称。
  362. % 集合(必填):顶点应插入的顶点集合的名称。
  363. % 查询参数
  364. % waitForSync(可选):定义请求是否应等待直到同步到磁盘。
  365. % returnNew(可选):定义响应是否应包含文档的完整新版本。
  366. % 请求正文(对象)
  367. % 主体必须是要存储的JSON对象。
  368. % 将顶点添加到给定的集合。
  369. % HTTP 201如果可以添加顶点并且waitForSync为true,则返回。
  370. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  371. % 顶点:顶点的内部属性。
  372. % new:完整的新编写的顶点文档。包括请求主体中的所有书面属性以及ArangoDB生成的所有内部属性。仅在returnNew为true时存在。
  373. % HTTP 202如果请求成功,但waitForSync为false,则返回。
  374. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  375. % code:响应代码。
  376. % 顶点:存储顶点时生成的内部属性。不包括请求正文中给定的任何属性。
  377. % new:完整的新编写的顶点文档。包括请求主体中的所有书面属性以及ArangoDB生成的所有内部属性。仅在returnNew为true时存在。
  378. % HTTP 403如果您的用户权限不足,则返回。为了将顶点插入到图中,您至少需要具有以下特权:
  379. % Read Only 访问数据库。
  380. % Write 访问给定的集合。
  381. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  382. % code:响应代码。
  383. % errorNum:发生错误的ArangoDB错误号。
  384. % errorMessage:为此错误创建的消息。
  385. % HTTP 404如果找不到具有该名称的图形,则返回。或者,如果找到了图,但是此集合不是图的一部分。
  386. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  387. % code:响应代码。
  388. % errorNum:发生错误的ArangoDB错误号。
  389. % errorMessage:为此错误创建的消息。
  390. newGharialVertex(PoolNameOrSocket, GraphName, CollName, MapData) ->
  391. Path = <<"/_api/gharial/", GraphName/binary, "/vertex/", CollName/binary>>,
  392. BodyStr = jiffy:encode(MapData),
  393. agHttpCli:callAgency(PoolNameOrSocket, ?AgPost, Path, [], BodyStr).
  394. newGharialVertex(PoolNameOrSocket, GraphName, CollName, MapData, QueryPars) ->
  395. QueryBinary = agMiscUtils:spellQueryPars(QueryPars),
  396. Path = <<"/_api/gharial/", GraphName/binary, "/vertex/", CollName/binary, QueryBinary/binary>>,
  397. BodyStr = jiffy:encode(MapData),
  398. agHttpCli:callAgency(PoolNameOrSocket, ?AgPost, Path, [], BodyStr).
  399. % 获取现有顶点
  400. % GET /_api/gharial/{graph}/vertex/{collection}/{vertex}
  401. % 路径参数
  402. % 图(必填):图的名称。
  403. % 集合(必需):顶点所属的顶点集合的名称。
  404. % 顶点(必填):顶点的_key属性。
  405. % 查询参数
  406. % rev(可选):必须包含修订。如果设置了此选项,则仅在具有此修订版本的情况下才返回文档。另请参见if-match标头作为替代方法。
  407. % 标头参数
  408. % if-match(可选):如果给出了“ If-Match”标头,则它必须恰好包含一个Etag。如果文档的版本与给定的Etag相同,则返回文档。否则,返回HTTP 412。或者,您可以在查询参数rev中提供Etag 。
  409. % if-none-match(可选):如果给出了“ If-None-Match”标头,则它必须恰好包含一个Etag。仅当文档的版本与给定的Etag不同时,才返回文档。否则,返回HTTP 304。
  410. % 从给定的集合中获取一个顶点。
  411. % HTTP 200如果可以找到顶点,则返回。
  412. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  413. % code:响应代码。
  414. % 顶点:完整的顶点。
  415. % HTTP 304如果给出了if-none-match标头,并且当前存储的顶点仍具有此修订值,则返回。因此,在上一次调用者获取顶点之间没有更新。
  416. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  417. % code:响应代码。
  418. % errorNum:发生错误的ArangoDB错误号。
  419. % errorMessage:为此错误创建的消息。
  420. % HTTP 403如果您的用户权限不足,则返回。为了更新图中的顶点,您至少需要具有以下特权:
  421. % Read Only 访问数据库。
  422. % Read Only 访问给定的集合。
  423. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  424. % code:响应代码。
  425. % errorNum:发生错误的ArangoDB错误号。
  426. % errorMessage:为此错误创建的消息。
  427. % 在以下情况下返回HTTP 404:
  428. % 找不到具有该名称的图。
  429. % 该集合不属于图形。
  430. % 顶点不存在。
  431. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  432. % code:响应代码。
  433. % errorNum:发生错误的ArangoDB错误号。
  434. % errorMessage:为此错误创建的消息。
  435. % HTTP 412如果给出了if-match标头,则返回,但是存储的文档版本不同。
  436. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  437. % code:响应代码。
  438. % errorNum:发生错误的ArangoDB错误号。
  439. % errorMessage:为此错误创建的消息。
  440. getGharialVertex(PoolNameOrSocket, GraphName, CollName, VertexKey) ->
  441. Path = <<"/_api/gharial/", GraphName/binary, "/vertex/", CollName/binary, "/", (agMiscUtils:toBinary(VertexKey) / binary)>>,
  442. agHttpCli:callAgency(PoolNameOrSocket, ?AgGet, Path, [], undefined).
  443. getGharialVertex(PoolNameOrSocket, GraphName, CollName, VertexKey, Headers, QueryPars) ->
  444. QueryBinary = agMiscUtils:spellQueryPars(QueryPars),
  445. Path = <<"/_api/gharial/", GraphName/binary, "/vertex/", CollName/binary, "/", (agMiscUtils:toBinary(VertexKey) / binary), QueryBinary/binary>>,
  446. agHttpCli:callAgency(PoolNameOrSocket, ?AgGet, Path, Headers, undefined).
  447. % 更新现有顶点
  448. % PATCH /_api/gharial/{graph}/vertex/{collection}/{vertex}
  449. % 路径参数
  450. % 图(必填):图的名称。
  451. % 集合(必需):顶点所属的顶点集合的名称。
  452. % 顶点(必填):顶点的_key属性。
  453. % 查询参数
  454. % waitForSync(可选):定义请求是否应等待直到同步到磁盘。
  455. % keepNull(可选):定义是否应存储设置为null的值。默认情况下(true),给定的documents(s)属性将设置为null。如果此参数为false,则将属性从文档中删除。
  456. % returnOld(可选):定义是否应在响应对象内返回已删除文档的表示。
  457. % returnNew(可选):定义是否应在响应对象中返回新文档的表示形式。
  458. % 标头参数
  459. % if-match(可选):如果给出了“ If-Match”标头,则它必须恰好包含一个Etag。如果文档的版本与给定的Etag相同,则文档将被更新。否则,返回HTTP 412。或者,您可以在URL的属性rev中提供Etag。
  460. % 请求正文(对象)
  461. % 主体必须包含一个JSON对象,该对象完全包含应被覆盖的属性,所有其他属性保持不变。
  462. % 更新集合中特定顶点的数据。
  463. % HTTP 200如果可以更新顶点且waitForSync为true,则返回。
  464. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  465. % code:响应代码。
  466. % 顶点:顶点的内部属性。
  467. % new:完整的新编写的顶点文档。包括请求主体中的所有书面属性以及ArangoDB生成的所有内部属性。仅在returnNew为true时存在。
  468. % old:完整的覆盖顶点文档。包括此操作之前存储的所有属性。仅在returnOld为true时存在。
  469. % HTTP 202如果请求成功,则返回,并且waitForSync为false。
  470. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  471. % code:响应代码。
  472. % 顶点:顶点的内部属性。
  473. % new:完整的新编写的顶点文档。包括请求主体中的所有书面属性以及ArangoDB生成的所有内部属性。仅在returnNew为true时存在。
  474. % old:完整的覆盖顶点文档。包括此操作之前存储的所有属性。仅在returnOld为true时存在。
  475. % HTTP 403如果您的用户权限不足,则返回。为了更新图中的顶点,您至少需要具有以下特权:
  476. % Read Only 访问数据库。
  477. % Write 访问给定的集合。
  478. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  479. % code:响应代码。
  480. % errorNum:发生错误的ArangoDB错误号。
  481. % errorMessage:为此错误创建的消息。
  482. % 在以下情况下返回HTTP 404:
  483. % 找不到具有该名称的图。
  484. % 该集合不属于图形。
  485. % 要更新的顶点不存在。
  486. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  487. % code:响应代码。
  488. % errorNum:发生错误的ArangoDB错误号。
  489. % errorMessage:为此错误创建的消息。
  490. % HTTP 412如果给出了if-match标头,则返回,但是存储的文档版本不同。
  491. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  492. % code:响应代码。
  493. % errorNum:发生错误的ArangoDB错误号。
  494. % errorMessage:为此错误创建的消息。
  495. updateGharialVertex(PoolNameOrSocket, GraphName, CollName, VertexKey, MapData) ->
  496. Path = <<"/_api/gharial/", GraphName/binary, "/vertex/", CollName/binary, "/", (agMiscUtils:toBinary(VertexKey) / binary)>>,
  497. BodyStr = jiffy:encode(MapData),
  498. agHttpCli:callAgency(PoolNameOrSocket, ?AgPatch, Path, [], BodyStr).
  499. updateGharialVertex(PoolNameOrSocket, GraphName, CollName, VertexKey, MapData, Headers, QueryPars) ->
  500. QueryBinary = agMiscUtils:spellQueryPars(QueryPars),
  501. Path = <<"/_api/gharial/", GraphName/binary, "/vertex/", CollName/binary, "/", (agMiscUtils:toBinary(VertexKey) / binary), QueryBinary/binary>>,
  502. BodyStr = jiffy:encode(MapData),
  503. agHttpCli:callAgency(PoolNameOrSocket, ?AgPatch, Path, Headers, BodyStr).
  504. % 替换现有的顶点
  505. % PUT /_api/gharial/{graph}/vertex/{collection}/{vertex}
  506. % 路径参数
  507. % 图(必填):图的名称。
  508. % 集合(必需):顶点所属的顶点集合的名称。
  509. % 顶点(必填):顶点的_key属性。
  510. % 查询参数
  511. % waitForSync(可选):定义请求是否应等待直到同步到磁盘。
  512. % keepNull(可选):定义是否应存储设置为null的值。默认情况下,密钥不会从文档中删除。
  513. % returnOld(可选):定义是否应在响应对象内返回已删除文档的表示。
  514. % returnNew(可选):定义是否应在响应对象中返回新文档的表示形式。
  515. % 标头参数
  516. % if-match(可选):如果给出了“ If-Match”标头,则它必须恰好包含一个Etag。如果文档的版本与给定的Etag相同,则文档将被更新。否则,返回HTTP 412。或者,您可以在URL的属性rev中提供Etag。
  517. % 请求正文(对象)
  518. % 主体必须是要存储的JSON对象。
  519. % 替换集合中顶点的数据。
  520. % HTTP 200如果可以替换顶点且waitForSync为true,则返回。
  521. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  522. % code:响应代码。
  523. % 顶点:顶点的内部属性。
  524. % new:完整的新编写的顶点文档。包括请求主体中的所有书面属性以及ArangoDB生成的所有内部属性。仅在returnNew为true时存在。
  525. % old:完整的覆盖顶点文档。包括此操作之前存储的所有属性。仅在returnOld为true时存在。
  526. % HTTP 202如果可以替换顶点且waitForSync为false,则返回。
  527. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  528. % code:响应代码。
  529. % 顶点:顶点的内部属性。
  530. % new:完整的新编写的顶点文档。包括请求主体中的所有书面属性以及ArangoDB生成的所有内部属性。仅在returnNew为true时存在。
  531. % old:完整的覆盖顶点文档。包括此操作之前存储的所有属性。仅在returnOld为true时存在。
  532. % HTTP 403如果您的用户权限不足,则返回。为了替换图中的顶点,您至少需要具有以下特权:
  533. % Read Only 访问数据库。
  534. % Write 访问给定的集合。
  535. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  536. % code:响应代码。
  537. % errorNum:发生错误的ArangoDB错误号。
  538. % errorMessage:为此错误创建的消息。
  539. % 在以下情况下返回HTTP 404:
  540. % 找不到具有该名称的图。
  541. % 该集合不属于图形。
  542. % 要替换的顶点不存在。
  543. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  544. % code:响应代码。
  545. % errorNum:发生错误的ArangoDB错误号。
  546. % errorMessage:为此错误创建的消息。
  547. % HTTP 412如果给出了 if -match标头,则返回,但是存储的文档版本不同。
  548. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  549. % code:响应代码。
  550. % errorNum:发生错误的ArangoDB错误号。
  551. % errorMessage:为此错误创建的消息。
  552. replaceGharialVertex(PoolNameOrSocket, GraphName, CollName, VertexKey, MapData) ->
  553. Path = <<"/_api/gharial/", GraphName/binary, "/vertex/", CollName/binary, "/", (agMiscUtils:toBinary(VertexKey) / binary)>>,
  554. BodyStr = jiffy:encode(MapData),
  555. agHttpCli:callAgency(PoolNameOrSocket, ?AgPut, Path, [], BodyStr).
  556. replaceGharialVertex(PoolNameOrSocket, GraphName, CollName, VertexKey, MapData, Headers, QueryPars) ->
  557. QueryBinary = agMiscUtils:spellQueryPars(QueryPars),
  558. Path = <<"/_api/gharial/", GraphName/binary, "/vertex/", CollName/binary, "/", (agMiscUtils:toBinary(VertexKey) / binary), QueryBinary/binary>>,
  559. BodyStr = jiffy:encode(MapData),
  560. agHttpCli:callAgency(PoolNameOrSocket, ?AgPut, Path, Headers, BodyStr).
  561. % 从图中删除顶点
  562. % DELETE /_api/gharial/{graph}/vertex/{collection}/{vertex}
  563. % 路径参数
  564. % 图(必填):图的名称。
  565. % 集合(必需):顶点所属的顶点集合的名称。
  566. % 顶点(必填):顶点的_key属性。
  567. % 查询参数
  568. % waitForSync(可选):定义请求是否应等待直到同步到磁盘。
  569. % returnOld(可选):定义是否应在响应对象内返回已删除文档的表示。
  570. % 标头参数
  571. % if-match(可选):如果给出了“ If-Match”标头,则它必须恰好包含一个Etag。如果文档的版本与给定的Etag相同,则文档将被更新。否则,返回HTTP 412。或者,您可以在URL的属性rev中提供Etag。
  572. % 从集合中删除一个顶点。
  573. % HTTP 200如果可以删除顶点,则返回。
  574. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  575. % code:响应代码。
  576. % 删除:设置为true,如果删除成功。
  577. % old:完整的删除的顶点文档。包括此操作之前存储的所有属性。仅在returnOld为true时存在。
  578. % HTTP 202如果请求成功,但waitForSync为false,则返回。
  579. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  580. % code:响应代码。
  581. % 删除:设置为true,如果删除成功。
  582. % old:完整的删除的顶点文档。包括此操作之前存储的所有属性。仅在returnOld为true时存在。
  583. % HTTP 403如果您的用户权限不足,则返回。为了删除图中的顶点,您至少需要具有以下特权:
  584. % Read Only 访问数据库。
  585. % Write 访问给定的集合。
  586. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  587. % code:响应代码。
  588. % errorNum:发生错误的ArangoDB错误号。
  589. % errorMessage:为此错误创建的消息。
  590. % 在以下情况下返回HTTP 404:
  591. % 找不到具有该名称的图。
  592. % 该集合不属于图形。
  593. % 要删除的顶点不存在。
  594. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  595. % code:响应代码。
  596. % errorNum:发生错误的ArangoDB错误号。
  597. % errorMessage:为此错误创建的消息。
  598. % HTTP 412如果给出了if-match标头,则返回,但是存储的文档版本不同。
  599. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  600. % code:响应代码。
  601. % errorNum:发生错误的ArangoDB错误号。
  602. % errorMessage:为此错误创建的消息。
  603. delGharialVertex(PoolNameOrSocket, GraphName, CollName, VertexKey) ->
  604. Path = <<"/_api/gharial/", GraphName/binary, "/vertex/", CollName/binary, "/", (agMiscUtils:toBinary(VertexKey) / binary)>>,
  605. agHttpCli:callAgency(PoolNameOrSocket, ?AgPut, Path, [], undefined).
  606. delGharialVertex(PoolNameOrSocket, GraphName, CollName, VertexKey, Headers, QueryPars) ->
  607. QueryBinary = agMiscUtils:spellQueryPars(QueryPars),
  608. Path = <<"/_api/gharial/", GraphName/binary, "/vertex/", CollName/binary, "/", (agMiscUtils:toBinary(VertexKey) / binary), QueryBinary/binary>>,
  609. agHttpCli:callAgency(PoolNameOrSocket, ?AgPut, Path, Headers, undefined).
  610. % 在现有图形中创建边
  611. % POST /_api/gharial/{graph}/edge/{collection}
  612. % 路径参数
  613. % 图(必填):图的名称。
  614. % 集合(必填):边缘所属的边缘集合的名称。
  615. % 查询参数
  616. % waitForSync(可选):定义请求是否应等待直到同步到磁盘。
  617. % returnNew(可选):定义响应是否应包含文档的完整新版本。
  618. % 具有以下属性的JSON对象是必需的:
  619. % _from:此边的源顶点。必须在使用的边定义内有效。
  620. % _to:此边的目标顶点。必须在使用的边定义内有效。
  621. % 在集合中创建新边缘。在主体内,边缘必须包含一个_from和_to值,以引用图中的有效顶点。此外,边缘在所使用的边缘集合的定义中必须有效 。
  622. % HTTP 201如果可以创建边缘并且waitForSync为true,则返回。
  623. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  624. % code:响应代码。
  625. % edge:边缘的内部属性。
  626. % new:完整的新编写的边缘文档。包括请求主体中的所有书面属性以及ArangoDB生成的所有内部属性。仅在returnNew为true时存在。
  627. % HTTP 202如果请求成功,但waitForSync为false,则返回。
  628. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  629. % code:响应代码。
  630. % edge:边缘的内部属性。
  631. % new:完整的新编写的边缘文档。包括请求主体中的所有书面属性以及ArangoDB生成的所有内部属性。仅在returnNew为true时存在。
  632. % HTTP 400如果输入文档无效,则返回。例如,这可以是如果_from或_to丢失。
  633. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  634. % code:响应代码。
  635. % errorNum:发生错误的ArangoDB错误号。
  636. % errorMessage:为此错误创建的消息。
  637. % HTTP 403如果您的用户权限不足,则返回。为了将边插入图形中,您至少需要具有以下特权:
  638. % Read Only 访问数据库。
  639. % Write 访问给定的集合。
  640. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  641. % code:响应代码。
  642. % errorNum:发生错误的ArangoDB错误号。
  643. % errorMessage:为此错误创建的消息。
  644. % 在以下任何一种情况下返回的HTTP 404:
  645. % 找不到具有该名称的图形。
  646. % 该边缘集合不是图形的一部分。
  647. % 无论是_from或_to顶点不存在。
  648. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  649. % code:响应代码。
  650. % errorNum:发生错误的ArangoDB错误号。
  651. % errorMessage:为此错误创建的消息。
  652. newGharialEdge(PoolNameOrSocket, GraphName, CollName, MapData) ->
  653. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary>>,
  654. BodyStr = jiffy:encode(MapData),
  655. agHttpCli:callAgency(PoolNameOrSocket, ?AgPost, Path, [], BodyStr).
  656. newGharialEdge(PoolNameOrSocket, GraphName, CollName, MapData, QueryPars) ->
  657. QueryBinary = agMiscUtils:spellQueryPars(QueryPars),
  658. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary, QueryBinary/binary>>,
  659. BodyStr = jiffy:encode(MapData),
  660. agHttpCli:callAgency(PoolNameOrSocket, ?AgPost, Path, [], BodyStr).
  661. % 获得边
  662. % GET /_api/gharial/{graph}/edge/{collection}/{edge}
  663. % 路径参数
  664. % 图(必填):图的名称。
  665. % 集合(必填):边缘所属的边缘集合的名称。
  666. % edge(必填):边缘的_key属性。
  667. % 查询参数
  668. % rev(可选):必须包含修订。如果设置了此选项,则仅在具有此修订版本的情况下才返回文档。另请参见if-match标头作为替代方法。
  669. % 标头参数
  670. % if-match(可选):如果给出了“ If-Match”标头,则它必须恰好包含一个Etag。如果文档的版本与给定的Etag相同,则返回文档。否则,返回HTTP 412。或者,您可以在URL的属性rev中提供Etag。
  671. % if-none-match(可选):如果给出了“ If-None-Match”标头,则它必须恰好包含一个Etag。仅当文档的版本与给定的Etag不同时,才返回文档。否则,返回HTTP 304。
  672. % 从给定的集合中获取一条边。
  673. % HTTP 200如果可以找到边缘,则返回。
  674. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  675. % code:响应代码。
  676. % edge:完整的边缘。
  677. % HTTP 304如果给出了if-none-match标头,并且当前存储的边缘仍具有此修订值,则返回。因此,调用者上一次获取边缘之间没有更新。
  678. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  679. % code:响应代码。
  680. % errorNum:发生错误的ArangoDB错误号。
  681. % errorMessage:为此错误创建的消息。
  682. % HTTP 403如果您的用户权限不足,则返回。为了更新图中的顶点,您至少需要具有以下特权:
  683. % Read Only 访问数据库。
  684. % Read Only 访问给定的集合。
  685. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  686. % code:响应代码。
  687. % errorNum:发生错误的ArangoDB错误号。
  688. % errorMessage:为此错误创建的消息。
  689. % 在以下情况下返回HTTP 404:
  690. % 找不到具有该名称的图。
  691. % 该集合不属于图形。
  692. % 边不存在。
  693. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  694. % code:响应代码。
  695. % errorNum:发生错误的ArangoDB错误号。
  696. % errorMessage:为此错误创建的消息。
  697. % HTTP 412如果给出了if-match标头,则返回,但是存储的文档版本不同。
  698. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  699. % code:响应代码。
  700. % errorNum:发生错误的ArangoDB错误号。
  701. % errorMessage:为此错误创建的消息。
  702. getGharialEdge(PoolNameOrSocket, GraphName, CollName, EdgeKey) ->
  703. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary, "/", (agMiscUtils:toBinary(EdgeKey))/binary>>,
  704. agHttpCli:callAgency(PoolNameOrSocket, ?AgGet, Path, [], undefined).
  705. getGharialEdge(PoolNameOrSocket, GraphName, CollName, EdgeKey, Headers) ->
  706. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary, "/", (agMiscUtils:toBinary(EdgeKey))/binary>>,
  707. agHttpCli:callAgency(PoolNameOrSocket, ?AgGet, Path, Headers, undefined).
  708. % 修改现有边
  709. % PATCH /_api/gharial/{graph}/edge/{collection}/{edge}
  710. % 路径参数
  711. % 图(必填):图的名称。
  712. % 集合(必填):边缘所属的边缘集合的名称。
  713. % edge(必填):顶点的_key属性。
  714. % 查询参数
  715. % waitForSync(可选):定义请求是否应等待直到同步到磁盘。
  716. % keepNull(可选):定义是否应存储设置为null的值。默认情况下(true),给定的documents(s)属性将设置为null。如果此参数为false,则将从文档中删除该属性。
  717. % returnOld(可选):定义是否应在响应对象内返回已删除文档的表示。
  718. % returnNew(可选):定义是否应在响应对象中返回新文档的表示形式。
  719. % 标头参数
  720. % if-match(可选):如果给出了“ If-Match”标头,则它必须恰好包含一个Etag。如果文档的版本与给定的Etag相同,则文档将被更新。否则,返回HTTP 412。或者,您可以在URL的属性rev中提供Etag。
  721. % 请求正文(对象)
  722. % 主体必须包含一个JSON对象,该对象完全包含应被覆盖的属性,所有其他属性保持不变。
  723. % 更新集合中特定边的数据。
  724. % HTTP 200如果可以更新边缘,并且waitForSync为false,则返回。
  725. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  726. % code:响应代码。
  727. % edge:边缘的内部属性。
  728. % new:完整的新编写的边缘文档。包括请求主体中的所有书面属性以及ArangoDB生成的所有内部属性。仅在returnNew为true时存在。
  729. % old:完整的覆盖边缘文档。包括此操作之前存储的所有属性。仅在returnOld为true时存在。
  730. % HTTP 202如果请求成功,但waitForSync为false,则返回。
  731. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  732. % code:响应代码。
  733. % edge:边缘的内部属性。
  734. % new:完整的新编写的边缘文档。包括请求主体中的所有书面属性以及ArangoDB生成的所有内部属性。仅在returnNew为true时存在。
  735. % old:完整的覆盖边缘文档。包括此操作之前存储的所有属性。仅在returnOld为true时存在。
  736. % HTTP 403如果您的用户权限不足,则返回。为了更新图中的边,您至少需要具有以下特权:
  737. % Read Only 访问数据库。
  738. % Write 访问给定的集合。
  739. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  740. % code:响应代码。
  741. % errorNum:发生错误的ArangoDB错误号。
  742. % errorMessage:为此错误创建的消息。
  743. % 在以下情况下返回HTTP 404:
  744. % 找不到具有该名称的图。
  745. % 该集合不属于图形。
  746. % 要更新的边缘不存在。
  747. % 无论是_from或_to顶点不存在(如果更新)。
  748. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  749. % code:响应代码。
  750. % errorNum:发生错误的ArangoDB错误号。
  751. % errorMessage:为此错误创建的消息。
  752. % HTTP 412如果给出了if-match标头,则返回,但是存储的文档版本不同。
  753. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  754. % code:响应代码。
  755. % errorNum:发生错误的ArangoDB错误号。
  756. % errorMessage:为此错误创建的消息。
  757. updateGharialEdge(PoolNameOrSocket, GraphName, CollName, EdgeKey, MapData) ->
  758. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary, "/", (agMiscUtils:toBinary(EdgeKey))/binary>>,
  759. BodyStr = jiffy:encode(MapData),
  760. agHttpCli:callAgency(PoolNameOrSocket, ?AgPatch, Path, [], BodyStr).
  761. updateGharialEdge(PoolNameOrSocket, GraphName, CollName, EdgeKey, MapData, Headers, QueryPars) ->
  762. QueryBinary = agMiscUtils:spellQueryPars(QueryPars),
  763. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary, "/", (agMiscUtils:toBinary(EdgeKey))/binary, QueryBinary/binary>>,
  764. BodyStr = jiffy:encode(MapData),
  765. agHttpCli:callAgency(PoolNameOrSocket, ?AgPatch, Path, Headers, BodyStr).
  766. % 替换现有边的内容
  767. % PUT /_api/gharial/{graph}/edge/{collection}/{edge}
  768. % 路径参数
  769. % 图(必填):图的名称。
  770. % 集合(必填):边缘所属的边缘集合的名称。
  771. % edge(必填):顶点的_key属性。
  772. % 查询参数
  773. % waitForSync(可选):定义请求是否应等待直到同步到磁盘。
  774. % keepNull(可选):定义是否应存储设置为null的值。默认情况下,密钥不会从文档中删除。
  775. % returnOld(可选):定义是否应在响应对象内返回已删除文档的表示。
  776. % returnNew(可选):定义是否应在响应对象中返回新文档的表示形式。
  777. % 标头参数
  778. % if-match(可选):如果给出了“ If-Match”标头,则它必须恰好包含一个Etag。如果文档的版本与给定的Etag相同,则文档将被更新。否则,返回HTTP 412。或者,您可以在URL的属性rev中提供Etag。
  779. % 具有以下属性的JSON对象是必需的:
  780. % _from:此边的源顶点。必须在使用的边定义内有效。
  781. % _to:此边的目标顶点。必须在使用的边定义内有效。
  782. % 替换集合中边的数据。
  783. % HTTP 201如果请求成功但waitForSync为true,则返回。
  784. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  785. % code:响应代码。
  786. % edge:边的内部属性
  787. % new:完整的新编写的边缘文档。包括请求主体中的所有书面属性以及ArangoDB生成的所有内部属性。仅在returnNew为true时存在。
  788. % old:完整的覆盖边缘文档。包括此操作之前存储的所有属性。仅在returnOld为true时存在。
  789. % HTTP 202如果请求成功,但waitForSync为false,则返回。
  790. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  791. % code:响应代码。
  792. % edge:边的内部属性
  793. % new:完整的新编写的边缘文档。包括请求主体中的所有书面属性以及ArangoDB生成的所有内部属性。仅在returnNew为true时存在。
  794. % old:完整的覆盖边缘文档。包括此操作之前存储的所有属性。仅在returnOld为true时存在。
  795. % HTTP 403如果您的用户权限不足,则返回。为了替换图中的边,您至少需要具有以下特权:
  796. % Read Only 访问数据库。
  797. % Write 访问给定的集合。
  798. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  799. % code:响应代码。
  800. % errorNum:发生错误的ArangoDB错误号。
  801. % errorMessage:为此错误创建的消息。
  802. % 在以下情况下返回HTTP 404:
  803. % 找不到具有该名称的图。
  804. % 该集合不属于图形。
  805. % 替换的边不存在。
  806. % 无论是_from或_to顶点不存在。
  807. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  808. % code:响应代码。
  809. % errorNum:发生错误的ArangoDB错误号。
  810. % errorMessage:为此错误创建的消息。
  811. % HTTP 412如果给出了if-match标头,则返回,但是存储的文档版本不同。
  812. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  813. % code:响应代码。
  814. % errorNum:发生错误的ArangoDB错误号。
  815. % errorMessage:为此错误创建的消息。
  816. replaceGharialEdge(PoolNameOrSocket, GraphName, CollName, EdgeKey, MapData) ->
  817. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary, "/", (agMiscUtils:toBinary(EdgeKey))/binary>>,
  818. BodyStr = jiffy:encode(MapData),
  819. agHttpCli:callAgency(PoolNameOrSocket, ?AgPut, Path, [], BodyStr).
  820. replaceGharialEdge(PoolNameOrSocket, GraphName, CollName, EdgeKey, MapData, Headers, QueryPars) ->
  821. QueryBinary = agMiscUtils:spellQueryPars(QueryPars),
  822. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary, "/", (agMiscUtils:toBinary(EdgeKey))/binary, QueryBinary/binary>>,
  823. BodyStr = jiffy:encode(MapData),
  824. agHttpCli:callAgency(PoolNameOrSocket, ?AgPut, Path, Headers, BodyStr).
  825. % 从图形中删除边
  826. % DELETE /_api/gharial/{graph}/edge/{collection}/{edge}
  827. % 路径参数
  828. % 图(必填):图的名称。
  829. % 集合(必填):边缘所属的边缘集合的名称。
  830. % edge(必填):边缘的_key属性。
  831. % 查询参数
  832. % waitForSync(可选):定义请求是否应等待直到同步到磁盘。
  833. % returnOld(可选):定义是否应在响应对象内返回已删除文档的表示。
  834. % 标头参数
  835. % if-match(可选):如果给出了“ If-Match”标头,则它必须恰好包含一个Etag。如果文档的版本与给定的Etag相同,则文档将被更新。否则,返回HTTP 412。或者,您可以在URL的属性rev中提供Etag。
  836. % 从集合中删除边缘。
  837. % HTTP 200如果可以删除边缘,则返回。
  838. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  839. % code:响应代码。
  840. % 删除:设置为true,如果删除成功。
  841. % old:完整的已删除边缘文档。包括此操作之前存储的所有属性。仅在returnOld为true时存在。
  842. % HTTP 202如果请求成功,但waitForSync为false,则返回。
  843. % error:如果有错误,则标记(true),否则(false)。这个回应是错误的。
  844. % code:响应代码。
  845. % 删除:设置为true,如果删除成功。
  846. % old:完整的已删除边缘文档。包括此操作之前存储的所有属性。仅在returnOld为true时存在。
  847. % HTTP 403如果您的用户权限不足,则返回。为了删除图中的顶点,您至少需要具有以下特权:
  848. % Read Only 访问数据库。
  849. % Write 访问给定的集合。
  850. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  851. % code:响应代码。
  852. % errorNum:发生错误的ArangoDB错误号。
  853. % errorMessage:为此错误创建的消息。
  854. % 在以下情况下返回HTTP 404:
  855. % 找不到具有该名称的图。
  856. % 该集合不属于图形。
  857. % 要删除的边缘不存在。
  858. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  859. % code:响应代码。
  860. % errorNum:发生错误的ArangoDB错误号。
  861. % errorMessage:为此错误创建的消息。
  862. % HTTP 412如果给出了if-match标头,则返回,但是存储的文档版本不同。
  863. % error:如果有错误,则标记(true),否则(false)。这个回应是真的。
  864. % code:响应代码。
  865. % errorNum:发生错误的ArangoDB错误号。
  866. % errorMessage:为此错误创建的消息。
  867. delGharialEdge(PoolNameOrSocket, GraphName, CollName, EdgeKey) ->
  868. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary, "/", (agMiscUtils:toBinary(EdgeKey))/binary>>,
  869. agHttpCli:callAgency(PoolNameOrSocket, ?AgDelete, Path, [], undefined).
  870. delGharialEdge(PoolNameOrSocket, GraphName, CollName, EdgeKey, Headers, QueryPars) ->
  871. QueryBinary = agMiscUtils:spellQueryPars(QueryPars),
  872. Path = <<"/_api/gharial/", GraphName/binary, "/edge/", CollName/binary, "/", (agMiscUtils:toBinary(EdgeKey))/binary, QueryBinary/binary>>,
  873. agHttpCli:callAgency(PoolNameOrSocket, ?AgPut, Path, Headers, undefined).