文档是CouchDB的中央数据结构。数据库的内容将以文档而不是表的形式存储。您可以使用CouchDB和Futon提供的cURL实用程序创建这些文档。本章介绍在数据库中创建文档的方法。

CouchDB中的每个文档都有唯一的ID。您可以选择自己的ID，该ID应该采用字符串形式。通常，使用UUID(通用唯一IDentifier)，它是创建重复项的机会最少的随机数。优选这些以避免碰撞。

使用cURL实用程序创建文档

您可以通过cURL实用程序使用PUT方法将HTTP请求发送到服务器，从而在CouchDB中创建文档。以下是创建文档的语法。

$ curl -X PUT http://127.0.0.1:5984/database name/"id" -d ' { document} '

使用-X ，我们可以在与HTTP服务器通信时指定正在使用的HTTP的自定义请求方法。在这种情况下，我们使用的是PUT方法。当我们使用PUT方法时，URL的内容指定了我们正在使用HTTP请求创建的对象名称。在这里，我们必须发送以下内容-

• 我们在其中创建文档的数据库名称的名称。

• 文件编号。

• 文档数据。 -d选项用于通过HTTP请求发送数据/文档。编写文档时，只需在花括号内输入用冒号分隔的“字段/值”对，如下所示-

{
   Name : Raju
   age : 23
   Designation : Designer
}

例

如果要在名称为my_database的数据库中创建ID为001的文档，请使用上述给定的语法，如下所示进行创建。

$ curl -X PUT http://127.0.0.1:5984/my_database/"001" -d
'{ " Name " : " Raju " , " age " :" 23 " , " Designation " : " Designer " }'

{"ok":true,"id":"001","rev":"1-1c2fae390fa5475d9b809301bbf3f25e"}

CouchDB对此请求的响应包含三个字段-

• “确定”，表示操作成功。

• “ id”，用于存储文档的ID和

• “ rev”，表示修订版本ID。每次修改(更新或修改)文档时，CouchDB都会生成_rev值。如果要更新或删除文档，CouchDB希望您包括要更改的修订的_rev字段。当CouchDB接受更改时，它将生成一个新的修订号。该机制确保并发控制。

验证

如果要查看创建的文档，可以使用如下所示的文档来获取它。

$ curl -X GET http://127.0.0.1:5984/my_database/001
{
   "_id": "001",
   "_rev": "1-3fcc78daac7a90803f0a5e383f4f1e1e",
   "Name": "Raju",
   "age": 23,
   "Designation": "Designer"
}

使用Futon创建文档

要创建文档，请打开http://127.0.0.1:5984/_utils/ URL，以获取CouchDB的Overview / index页面，如下所示。

选择要在其中创建文档的数据库。打开数据库的Overview页面，然后选择New Document选项，如下所示。

选择“新建文档”选项时，CouchDB将创建一个新的数据库文档，并为其分配一个新的ID。您可以编辑id的值，并可以以字符串形式分配自己的值。在下图中，我们创建了一个ID为001的新文档。

在此页面中，您可以观察三个选项-保存文档，添加字段和上传附件。

在文档中添加字段

要将字段添加到文档中，请单击“添加字段”选项。创建数据库后，可以使用此选项向其添加字段。单击它会为您提供一对文本框，即“字段”，“值”。您可以通过单击它们来编辑这些值。编辑这些值，然后输入所需的“字段-值”对。单击绿色按钮以保存这些值。

在下图中，我们创建了三个字段，名称，年龄和雇员名称。

保存文件

您可以通过单击此选项来保存对文档所做的更改。保存后，将生成一个新的ID _rev ，如下所示。