Spring Data ArangoOperations interface provides 'find' method to retrieve the document by id or key.
Signature
<T> Optional<T> find(Object id, Class<T> entityClass, DocumentReadOptions options) throws DataAccessException;
<T> Optional<T> find(Object id, Class<T> entityClass) throws DataAccessException;
Retrieves the document with the given id or key from a collection.
‘DocumentReadOptions’ is used to specify additional options while retrieving the document.
Below table summarizes the possible options associated with DocumentReadOptions.
Option |
Data type |
Description |
ifNoneMatch |
String |
Document revision must not contain If-None-Match |
ifMatch |
String |
document revision must contain If-Match |
catchException |
boolean |
whether or not catch possible thrown exceptions |
allowDirtyRead |
boolean |
If it is set to true then allows reading from followers in an active-failover setup. |
streamTransactionId |
String |
If set, the operation will be executed within the transaction. |
Example
DocumentReadOptions docReadOptions = new DocumentReadOptions();
docReadOptions.allowDirtyRead(true);
Optional<Employee> empOptById = arangoTemplate.find(docId, Employee.class, docReadOptions);
Find the below working application.
Step 1: Create new maven project ‘arango-template-doc-by-id-or-key’.
Step 2: Update pom.xml with maven dependencies.
pom.xml
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.sample.app</groupId>
<artifactId>arango-template-doc-by-id-or-key</artifactId>
<version>1</version>
<!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-parent -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.4.5</version>
</parent>
<dependencies>
<dependency>
<groupId>com.arangodb</groupId>
<artifactId>arangodb-spring-boot-starter</artifactId>
<version>2.3.3.RELEASE</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
Step 3: Define entity class.
Employee.java
package com.sample.app.entity;
import com.arangodb.springframework.annotation.ArangoId;
import com.arangodb.springframework.annotation.Document;
import org.springframework.data.annotation.Id;
@Document("employees")
public class Employee {
@Id // db document field: _key
private String key;
@ArangoId // db document field: _id
private String arangoId;
private Integer id;
private String firstName;
private String lastName;
private Integer age;
public Employee(Integer id, String firstName, String lastName) {
super();
this.id = id;
this.firstName = firstName;
this.lastName = lastName;
}
public Employee() {
}
public String getKey() {
return key;
}
public void setKey(String key) {
this.key = key;
}
public String getArangoId() {
return arangoId;
}
public void setArangoId(String arangoId) {
this.arangoId = arangoId;
}
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getFirstName() {
return firstName;
}
public void setFirstName(String firstName) {
this.firstName = firstName;
}
public String getLastName() {
return lastName;
}
public void setLastName(String lastName) {
this.lastName = lastName;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
@Override
public String toString() {
return "Employee [key=" + key + ", arangoId=" + arangoId + ", id=" + id + ", firstName=" + firstName
+ ", lastName=" + lastName + ", age=" + age + "]";
}
}
Step 4: Define arango configuration class.
ArangoConfig.java
package com.sample.app.config;
import org.springframework.context.annotation.Configuration;
import com.arangodb.ArangoDB;
import com.arangodb.springframework.annotation.EnableArangoRepositories;
import com.arangodb.springframework.config.ArangoConfiguration;
@Configuration
@EnableArangoRepositories(basePackages = { "com.sample.app" })
public class ArangoConfig implements ArangoConfiguration {
@Override
public ArangoDB.Builder arango() {
return new ArangoDB.Builder().host("localhost", 8529).user("root").password("tiger");
}
@Override
public String database() {
return "abc_org";
}
}
Step 5: Define main application class.
App.java
package com.sample.app;
import java.util.Optional;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import com.arangodb.entity.DocumentCreateEntity;
import com.arangodb.model.DocumentReadOptions;
import com.arangodb.springframework.core.ArangoOperations;
import com.arangodb.springframework.core.CollectionOperations;
import com.sample.app.entity.Employee;
@SpringBootApplication
public class App {
@Autowired
private ArangoOperations arangoTemplate;
public static void main(String args[]) {
SpringApplication.run(App.class, args);
}
@Bean
public CommandLineRunner demo() {
return (args) -> {
CollectionOperations empsCollection = arangoTemplate.collection(Employee.class);
empsCollection.drop();
Employee emp1 = new Employee(1, "Chamu", "M");
DocumentCreateEntity docCreateEntity = (DocumentCreateEntity) arangoTemplate.insert(emp1);
String docId = docCreateEntity.getId();
String docKey = docCreateEntity.getKey();
DocumentReadOptions docReadOptions = new DocumentReadOptions();
docReadOptions.allowDirtyRead(true);
Optional<Employee> empOptById = arangoTemplate.find(docId, Employee.class, docReadOptions);
Optional<Employee> empOptByKey = arangoTemplate.find(docKey, Employee.class, docReadOptions);
System.out.println("by id : " + empOptById.get());
System.out.println("by key : " + empOptByKey.get());
};
}
}
Total project structure looks like below.
Run App.java, you will see below messages in console.
by id : Employee [key=42474, arangoId=employees/42474, id=1, firstName=Chamu, lastName=M, age=null] by key : Employee [key=42474, arangoId=employees/42474, id=1, firstName=Chamu, lastName=M, age=null]
You can download complete working application from below link.
https://github.com/harikrishna553/springboot/tree/master/arangodb/arango-template-doc-by-id-or-key
Previous Next Home
No comments:
Post a Comment