Frames-OrientDB Plugin for play! framework 2
Java Scala
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

What is Frames-OrientDB Plugin ?

Frames-OrientDB plugin is a Java O/G mapper for the OrientDB with the Play! framework 2. It is used with the TinkerPop Frames for O/G mapping.


  • Object-Graph-Mapping by the TinkerPop Frames

  • Support for both the embedded OrientDB and remote OrientDB

  • Auto-reloading support

  • Custom vertex and edge types support (sample)

    • Note that Custom types, Constraints and Indexes are not yet implemented.
  • Support to enable to customize the format of Model Id (src)

  • On only embedded OrienDB:


  • Java 5 or 6, 7
  • Play 2.2.1


  • OrientDB 1.5.1


  1. Install Play framework 2.2.1

  2. Executing the command for installing the TinkerPop Frames Module

    % git clone % cd play21-frames-module % git checkout 2.4.4

  3. Publishing the Frames Module to your local repository

    % cd play21-frames-module % play publish-local

  4. Executing the command for installing the Frames-OrientDB Plugin

    % git clone

  5. Publishing the Frames-OrientDB Plugin to your local repository

    % cd play21-frames-orientdb-plugin % play publish-local

Running sample application

At a command prompt, type the following commands:

     % cd play21-frames-orientdb-plugin
     % cd samples
     % cd frames-simple-app
     % play run

There are basic usage in the source code of a sample application.

Facade Classes for GraphDB

The com.wingnest.play2.frames.GraphDB class is a Facade class.

  • GraphDB.commit()
  • GraphDB.rollback()
  • GraphDB.getGraph()
  • GraphDB.createFramedGraph()
  • GraphDB.getGraphManager()
  • GraphDB.createKeyIndex()
  • GraphDB.dropKeyIndex()
  • GraphDB.createIndex()
  • GraphDB.dropIndex()
  • GraphDB.getIndexedKeys()
  • GraphDB.getIndex()
  • GraphDB.getIndices()

The com.wingnest.play2.frames.[OrientDB] (app/com/wingnest/play2/frames/ class is a Facade class.

  • OrientDB.fromCustomIdToORID()
  • OrientDB.fromORIDToCustomId()
  • OrientDB.setCustomIdHandler()

Extended Annotations

For Models

####@Id Defines one attribute as id attribute.


   public interface A {
     public Object getId();

####@CustomId Defines one attribute as custom id attribute. (ref:(CustomIdManager))


   public interface A {
     public Object getCustomId();

####@IndexedProperty Defines one or more attributes as indexed attribute.


   public interface A {
      public String getType();
      public void setType(String type);

   Index<Vertex> index = GraphDB.getIndex(A.class.getSimpleName(), Vertex.class);
   Iterable<Vertex> types = index.get("type", "text");

For Controllers

####@WithGraphDB The @WithGraphDB annotation enables annotated Actions and/or Controllers to use OrientDB implicitly.

Known Issues

  • Nothing


Frames-OrientDB Plugin is distributed under the Apache 2 licence.