Proteus
ArangoDB driver for Scala.
The word 'Proteus' comes the adjective protean, with the general meaning of "versatile", "mutable", "capable of assuming many forms". "Protean" has positive connotations of flexibility, versatility and adaptability. The name Proteus is a nod to the versatile and many-formed nature of ArangoDB.
This driver is compatible with ArangoDB v3.6.x
Getting Started
You may need to add the Sonatype nexus to your resolvers:
resolvers ++= Seq("OSS" at "http://oss.sonatype.org/content/repositories/releases")
sbt:
libraryDependencies += "com.cornfluence" % "proteus_2.13" % "0.7.3"
maven:
<dependency>
<groupId>com.cornfluence</groupId>
<artifactId>proteus_2.13</artifactId>
<version>0.7.3</version>
<classifier>sources</classifier>
</dependency>
Note: Versions of Proteus greater than 0.7.0 are for ArangoDB 3.6.+ and built with Scala 2.13
Configuration
To configure your application's ArangoDB user, you will need to create a ProteusConfig configuration object to initialize the document and graph clients. You will most likely want to materialize the configuration case class from an application.conf that looks like the following so you can materialize it to a case class using Config.configuration
in your calling code:
proteus {
host = "localhost"
user = "root"
password = "openSesame"
port = "8529",
tls = false
}
You can also create the ProteusConfig manually in your source like so:
ProteusConfig(
host: String = "localhost",
user: String,
password: String,
port: String = "8529",
tls: Boolean = false
)
Examples
Client API
val arangoClient = ArangoClient(config = ProteusConfig(...))
val documentClient = DocumentClient(config = ProteusConfig(...), databaseName = "testDB")
val graphClient = GraphClient(config = ProteusConfig(...), graphName = "testGraph")
Database API
Create a database:
arangoClient.createDatabase("dbName", List(User(username = "user", password = "pass", active = true)))
arangoClient.getDatabaseList
arangoClient.getCurrentDatabase
Delete a database:
arangoClient.deleteDatabase("dbName")
Collection API
arangoClient.createCollection("dbName", testCollection)
arangoClient.dropCollection("dbName", testCollection)
Document API
Create a document (returning the document id as a string):
documentClient.createDocument("testCollection","""{ "Hello": "World" }""")
Fetch all documents:
documentClient.getAllDocuments("testCollection")
Fetch a single document:
documentClient.getDocument("testCollection", "documentID")
Update/Replace a document:
documentClient.replaceDocument("testCollection", "documentID","""{ "Hello": "World" }""")
Remove a document:
documentClient.deleteDocument("testCollection", "documentID")
Graph API
(Graph API is still under some development)
Create a graph
graphClient.createGraph(List())
Drop a graph
graphClient.dropGraph()
Create a vertex collection
graphClient.createVertexCollection("vertexCollectionName")
Create an edge collection
graphClient.createEdgeCollection("edgeCollectionName", List("vertexCollectionName"), List("otherVertexCollectionName"))
Create a vertex
graphClient.createVertex("vertexCollectionName", """{"free":"style"}""")
Create an edge
graphClient.createEdge("edgeCollectionName", "typeName", "vertexOneID", "vertexTwoID")
Delete an edge
graphClient.deleteEdge("edgeCollectionName", "edgeKey")
Delete an edge collection
graphClient.deleteEdgeCollection("edgeCollectionName")
Delete a vertex
graphClient.deleteVertex("vertexCollectionName", "vertexKey")
Delete a vertex collection
graphClient.deleteVertexCollection("vertexCollectionName")