这是一个关于如何用Java Sync Driver 4.1使用ArangoDB的简短教程。在不到10分钟的时间内,您将学会如何用Java 操作ArangoDB (ArangoDB on Github)。有关驱动程序的功能和性能的更多细节,请查看相应的博客文章。
*请注意: 本教程是针对 ArangoDB 3.1版本编写的,有可能不支持旧版本。
如果您使用的是旧版本的ArangoDB,请查看为旧版本设计的Java教程。*
安装Java驱动程序
本教程将在Eclipse中介绍Java驱动程序的用法。首先,通过maven
将Java驱动程序添加到您的项目中:
1
2
3
4 com.arangodb
5 arangodb-java-driver
6 4.1.0
7
8 ....
使用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.0.0
)
注意: 确保安装并运行ArangoDB 3.1或更高版本。
快速开始
创建一个名为 FirstProject
的文件并写入:
1
2 package mydb.firstproject;
3
4 import java.util.Map;
5
6 import com.arangodb.ArangoCollection;
7 import com.arangodb.ArangoCursor;
8 import com.arangodb.ArangoDB;
9 import com.arangodb.ArangoDBException;
10 import com.arangodb.entity.BaseDocument;
11 import com.arangodb.entity.CollectionEntity;
12 import com.arangodb.util.MapBuilder;
13 import com.arangodb.velocypack.VPackSlice;
14 import com.arangodb.velocypack.exception.VPackException;
15
16 public class FirstProject {
17 public static void main(final String[] args) {
18
19 }
}
在eclipse中,您需要创建一个名为 FirstProject
的新类,并将代码复制到其中。在本教程的过程中,将使用代码中给出的每个 import
。
连接
配置和打开连接以启动ArangoDB。
1 ArangoDB arangoDB = new ArangoDB.Builder().build();
提示: 原始连接为 http://127.0.0.1:8529.
创建数据库
我们来创建一个新的数据库:
1
2 String dbName = "mydb";
3 try {
4 arangoDB.createDatabase(dbName);
5 System.out.println("Database created: " + dbName);
6
} catch (ArangoDBException e) {
7 System.err.println("Failed to create database: " + dbName + "; " + e.getMessage());
}
结果是应该是:
Database created: mydb
创建一个集合
现在让我们来创建我们的第一个集合:
1
2 String collectionName = "firstCollection";
3 try {
4 CollectionEntity myArangoCollection = arangoDB.db(dbName).createCollection(collectionName);
5 System.out.println("Collection created: " + myArangoCollection.getName());
6 } catch (ArangoDBException e) {
7 System.err.println("Failed to create collection: " + collectionName + "; " + e.getMessage());
}
结果是应该是:
1 Collection created: firstCollection
您应该了解的一些细节代码:
createCollection()
创建集合
firstCollection
是集合的名字
创建文档
现在我们在集合中创建一个文档。任何对象都可以作为文档添加到数据库中,并作为对象从数据库中检索。
这个例子中,我们使用驱动程序提供的BaseDocument
类。文档的属性存储在映射中,作为键/值