ArangoDB教程：Java 10分钟

这是一个关于如何用Java Sync Driver使用ArangoDB的简短教程。在不到10分钟的时间内，您将学会如何用Java 操作ArangoDB。有关驱动程序的功能和性能的更多细节，请查看相应的博客文章。

请注意: 本教程是针对 ArangoDB 3.1版本编写的，有可能不支持旧版本。

如果您使用的是旧版本的ArangoDB，请查看为旧版本设计的Java教程。

安装Java驱动程序

本教程将在Eclipse中介绍Java驱动程序的用法。首先，通过maven将Java驱动程序添加到您的项目中：

<groupId>com.arangodb</groupId>

<artifactId>arangodb-java-driver</artifactId>

</dependency>

....

</dependencies>

使用eclipse，您需要执行以下步骤：

首先 file, 然后 new 然后点击 other
选择 Maven Project
选择工作区位置
选择默认的原型
最后选择一个Group id (mydb) 和一个Artifact id (firstproject) 然后点击完成
现在打开 pom.xml, 在标签 dependencies 然后点击添加
现在我们填写groupID (com.arangodb), artifactID(arangodb-java-driver) and version(4.2.2)

注意: 确保安装并运行ArangoDB 3.1或更高版本。

快速开始

创建一个名为 FirstProject 的文件并写入：

package mydb.firstproject;

import java.util.List;

import java.util.Map;

import java.util.HashMap;

import com.arangodb.ArangoCollection;

import com.arangodb.ArangoCursor;

import com.arangodb.ArangoDB;

import com.arangodb.ArangoDBException;

import com.arangodb.entity.BaseDocument;

import com.arangodb.entity.CollectionEntity;

import com.arangodb.model.AqlQueryOptions;

import com.arangodb.util.MapBuilder;

import com.arangodb.velocypack.VPackSlice;

import com.arangodb.velocypack.exception.VPackException;

public class FirstProject {

public static void main(final String[] args) {

}

在eclipse中，您需要创建一个名为 FirstProject的新类，并将代码复制到其中。在本教程的过程中，将使用代码中给出的每个 import。

连接

配置和打开连接以启动ArangoDB。

1	ArangoDB arangoDB = new ArangoDB.Builder().build();

提示: 原始连接为 http://127.0.0.1:8529.

创建数据库

我们来创建一个新的数据库：

String dbName = "mydb";

try {

arangoDB.createDatabase(dbName);

System.out.println("Database created: " + dbName);

} catch (ArangoDBException e) {

System.err.println("Failed to create database: " + dbName + "; " + e.getMessage());

}

结果是应该是：

1	Database created: mydb

创建一个集合

现在让我们来创建我们的第一个集合：

String collectionName = "firstCollection";

try {

CollectionEntity myArangoCollection = arangoDB.db(dbName).createCollection(collectionName);

System.out.println("Collection created: " + myArangoCollection.getName());

} catch (ArangoDBException e) {

System.err.println("Failed to create collection: " + collectionName + "; " + e.getMessage());

}

结果是应该是：

1	Collection created: firstCollection

您应该了解的一些细节代码：

createCollection() 创建集合
firstCollection 是集合的名字

创建文档

现在我们在集合中创建一个文档。任何对象都可以作为文档添加到数据库中，并作为对象从数据库中检索。

这个例子中，我们使用驱动程序提供的BaseDocument类。文档的属性存储在映射中，作为键<String>/值<Object> 对：

BaseDocument myObject = new BaseDocument();

myObject.setKey("myKey");

myObject.addAttribute("a", "Foo");

myObject.addAttribute("b", 42);

try {

arangoDB.db(dbName).collection(collectionName).insertDocument(myObject);

System.out.println("Document created");

} catch (ArangoDBException e) {

System.err.println("Failed to create document. " + e.getMessage());

}

结果应该是：

1	Document created

您应该了解的一些细节代码：

setKey() 设置新对象的键值
addAttribute() 将一个新的键/值对放在对象中
每个属性作为单个键／值对存储在文档根目录中

阅读文档

阅读创建的文档：

try {

BaseDocument myDocument = arangoDB.db(dbName).collection(collectionName).getDocument("myKey",

BaseDocument.class);

System.out.println("Key: " + myDocument.getKey());

System.out.println("Attribute a: " + myDocument.getAttribute("a"));

System.out.println("Attribute b: " + myDocument.getAttribute("b"));

} catch (ArangoDBException e) {

System.err.println("Failed to get document: myKey; " + e.getMessage());

}

结果应该是：

Key: myKey

Attribute a: Foo

Attribute b: 42

您应该了解的一些细节代码：

getDocument() 将存储的文档数据返回到给定的JavaBean (BaseDocument)

阅读VelocyPack 格式文档

您也可以阅读VelocyPack 格式文档:

try {

VPackSlice myDocument = arangoDB.db(dbName).collection(collectionName).getDocument("myKey",

VPackSlice.class);

System.out.println("Key: " + myDocument.get("_key").getAsString());

System.out.println("Attribute a: " + myDocument.get("a").getAsString());

System.out.println("Attribute b: " + myDocument.get("b").getAsInt());

} catch (ArangoDBException | VPackException e) {

System.err.println("Failed to get document: myKey; " + e.getMessage());

}

结果应该是：

Key: myKey

Attribute a: Foo

Attribute b: 42

您应该了解的一些细节代码：

getDocument() 将存储的文档数据返回到 VelocyPack 格式 (VPackSlice)

更新文档

myObject.addAttribute("c", "Bar");

try {

arangoDB.db(dbName).collection(collectionName).updateDocument("myKey", myObject);

} catch (ArangoDBException e) {

System.err.println("Failed to update document. " + e.getMessage());

}

再次阅读文件

我们再次阅读文件：

try {

BaseDocument myUpdatedDocument = arangoDB.db(dbName).collection(collectionName).getDocument("myKey",

BaseDocument.class);

System.out.println("Key: " + myUpdatedDocument.getKey());

System.out.println("Attribute a: " + myUpdatedDocument.getAttribute("a"));

System.out.println("Attribute b: " + myUpdatedDocument.getAttribute("b"));

System.out.println("Attribute c: " + myUpdatedDocument.getAttribute("c"));

} catch (ArangoDBException e) {

System.err.println("Failed to get document: myKey; " + e.getMessage());

}

结果应该是：

Key: myKey

Attribute a: Foo

Attribute b: 42

Attribute c: Bar

删除文档

让我们来删除一个文档：

try {

arangoDB.db(dbName).collection(collectionName).deleteDocument("myKey");

} catch (ArangoDBException e) {

System.err.println("Failed to delete document. " + e.getMessage());

}

执行AQL查询

首先我们需要在集合firstCollection中创建一些名称为Homer的文档：

ArangoCollection collection = arangoDB.db(dbName).collection(collectionName);

for (int i = 0; i < 10; i++) {

BaseDocument value = new BaseDocument();

value.setKey(String.valueOf(i));

value.addAttribute("name", "Homer");

collection.insertDocument(value);

}

从集合firstCollection中获取所有名称为Homer 的文档，并且遍历存储结果：

try {

String query = "FOR t IN firstCollection FILTER t.name == @name RETURN t";

Map<String, Object> bindVars = new MapBuilder().put("name", "Homer").get();

ArangoCursor<BaseDocument> cursor = arangoDB.db(dbName).query(query, bindVars, null,

BaseDocument.class);

cursor.forEachRemaining(aDocument -> {

System.out.println("Key: " + aDocument.getKey());

});

} catch (ArangoDBException e) {

System.err.println("Failed to execute query. " + e.getMessage());

}

结果应该是：

Key: 1

Key: 0

Key: 5

Key: 3

Key: 4

Key: 9

Key: 2

Key: 7

Key: 8

Key: 6

您应该了解的一些细节代码：

AQL 查询语法使用占位符@name 其必须被绑定到一个值
query() 执行定义的查询并返回一个具有给定类的ArangoCursor (这里: BaseDocument)
顺序不能保证

使用AQL删除文档

现在我们将删除之前创建的文档：

try {

String query = "FOR t IN firstCollection FILTER t.name == @name "

+ "REMOVE t IN firstCollection LET removed = OLD RETURN removed";

Map<String, Object> bindVars = new MapBuilder().put("name", "Homer").get();

ArangoCursor<BaseDocument> cursor = arangoDB.db(dbName).query(query, bindVars, null,

BaseDocument.class);

cursor.forEachRemaining(aDocument -> {

System.out.println("Removed document " + aDocument.getKey());

});

} catch (ArangoDBException e) {

System.err.println("Failed to execute query. " + e.getMessage());

}

结果应该是：

Removed document: 1

Removed document: 0

Removed document: 5

Removed document: 3

Removed document: 4

Removed document: 9

Removed document: 2

Removed document: 7

Removed document: 8

Removed document: 6

学习更多

查看AQL 文档，进一步学习我们的查询语言。
想更多地了解我们的数据库吗点击这里!
阅读关于Collections的更多信息。
在我们的文档中浏览更多关于Documents的信息。
相关更多示例，您可以浏览ArangoDB 菜谱。

This page has been translated from the original English version with great caution.
However, it might still contain mistakes. Please refer to the English version for binding information.