咨询执行ArangoDB HTTP API文档示例代码的工具

你之前的误会真的很正常，不少刚接触ArangoDB的朋友都会把arangosh和curl搞混。咱们直接说结论：

• 你看到的shell> curl -X POST --data-binary @- --dump - http://localhost:8529/_api/import?collection=products这类示例，用的是curl工具，完全不是arangosh.exe。

1. 先说说curl是什么？ #

curl是个跨平台的通用命令行工具，核心功能就是发送HTTP/HTTPS请求，Windows、Linux、macOS这些系统基本都支持。ArangoDB的HTTP API文档里的这类示例，就是用它来演示如何直接调用数据库的REST接口——你可以把它当成一个“万能HTTP请求发送器”，不光能用来操作ArangoDB，其他支持HTTP API的服务也能用它测试。

2. 那arangosh.exe是干啥的？ #

arangosh是ArangoDB自带的专属Shell工具，它基于JavaScript，是专门用来和ArangoDB交互的。在arangosh里，你得用ArangoDB的JS驱动语法操作数据库，比如写db.products.insert({name: "Apple"})这种代码，而不是直接敲curl命令。

3. 怎么快速区分两种示例？ #

• 如果示例开头是shell> curl ...，那就是用curl的命令行HTTP请求；
• 如果示例是JavaScript代码，比如db._create("products");或者db.products.save({...})，那才是要在arangosh里运行的代码。

给你举个直观的对比例子：

用curl批量导入的HTTP API示例：

curl -X POST --data-binary @- --dump - http://localhost:8529/_api/import?collection=products
# 接着输入要导入的JSON数据：
{"name":"Apple","price":1.99}
{"name":"Banana","price":0.99}

用arangosh批量导入的示例：

const docs = [
  {"name":"Apple","price":1.99},
  {"name":"Banana","price":0.99}
];
db.products.insert(docs);

这样以后看文档的时候，看示例的标识和代码类型，就不会再搞混啦。

内容的提问来源于stack exchange，提问作者Code Novice