JNoSQL/Artemis/Graph

1. Graph-extension


JNoSQL has the support of the Graph database through the TinkerPop project. Apache TinkerPop™ is a graph computing framework for both graph databases (OLTP) and graph analytic systems (OLAP). The TinkerPop has support to more than twenty Graph databases.

1. 1. Graph Template

 This template has the duty to be a bridge between the entity model and Graph database.
 
```java 
 

GraphTemplate graphTemplate =//instance

Person person = builder().withAge(27).withName("Otavio").build();

graphTemplate.insert(person);

person.setAge(29); graphTemplate.update(person); graphTemplate.delete(person.getId());

```

1. 1. Edge

  An Edge links two Vertex objects. Along with its Property objects, an Edge has both a Direction and a label. The Direction determines which Vertex is the tail Vertex (out Vertex) and which Vertex is the head Vertex (in Vertex). The Edge label determines the type of relationship that exists between the two vertices.

1. 1. 1. EdgeEntity<OUT, IN>

The representation of Edge that links two Entity. Along with its Property objects, an Edge has both a Direction and a label.

```java Person poliana = graphTemplate.insert(Person.builder().withName("Poliana").withAge(25).build()); Book shack = graphTemplate.insert(Book.builder().withAge(2007).withName("The Shack").build()); EdgeEntity<Person, Book> reads = graphTemplate.edge(poliana, "reads", shack); reads.add("where", "Brazil"); int size = edge.size(); String label = edge.getLabel(); Person outbound = edge.getOutbound(); Book inbound = edge.getInbound(); ```

1. 1. 1. 1. Find an EdgeEntity

```java Optional<EdgeEntity<Person, Book>> reads = graphTemplate.edge(edgeId); ```

1. 1. Repository

In addition to template class, Artemis has the Repository. This interface helps the Entity repository to save, update, delete and retrieve information.

To use Repository, just need to create a new interface that extends the Repository.

```java

interface PersonRepository extends Repository<Person, String> {

} ```

The qualifier is mandatory to define the database type that will be used at the injection point moment.

```java @Inject @Database(DatabaseType.GRAPH) private PersonRepository graphRepository; ```

So, Artemis will inject automatically.

```java

PersonRepository repository = //instance

Person person = new Person(); person.setNickname("diana"); person.setName("Diana Goodness");

List<Person> people = Collections.singletonList(person);

repository.save(person); repository.save(people);

```

1. 1. Transactional

The Transactional annotation provides the application the ability to declaratively control transaction boundaries on CDI managed beans. *org.apache.tinkerpop.gremlin.structure.Transaction*

```java

  @Transactional//that will use the current trasaction
   public void save(Site site) {
       repository.save(site);
   }
   //after the method will commit the transaction

```

1. 1. 1. Search information from Repository

The Repository also has a method query from the method name. These are the keywords:

• **findBy**: The prefix to find some information
• **deleteBy**: The prefix to delete some information

Also the operators:

• And
• Between
• LessThan
• GreaterThan
• LessThanEqual
• GreaterThanEqual
• OutV
• InV
• BothV

```java interface PersonRepository extends Repository<Person, Long> {

   List<Person> findByAddress(String address);

   Stream<Person> findByName(String name);

   Stream<Person> findByNameAndKnowsOutV(String name);
   
   Stream<Person> findByNameAndBothV(String name, String label);

   Optional<Person> findByNickname(String nickname);

   void deleteByNickName(String nickname);

} ```