NeoEMF Core

NeoEMF core component. Specialize the standard EMF classes and provide abstract classes for dedicated back-end extensions.

License

License

GroupId

GroupId

fr.inria.atlanmod.neoemf
ArtifactId

ArtifactId

neoemf-core
Last Version

Last Version

2.0.0
Release Date

Release Date

Type

Type

bundle
Description

Description

NeoEMF Core
NeoEMF core component. Specialize the standard EMF classes and provide abstract classes for dedicated back-end extensions.
Project Organization

Project Organization

Atlanmod

Download neoemf-core

Dependencies

compile (7)

Group / Artifact Type Version
org.atlanmod.commons : commons-core jar 1.0.4
net.openhft : chronicle-map jar 3.17.1
net.openhft : chronicle-bytes jar 2.17.19
cglib : cglib-nodep jar 3.2.10
org.eclipse.emf : org.eclipse.emf.common jar 2.15.0
org.eclipse.emf : org.eclipse.emf.ecore jar 2.15.0
fr.inria.atlanmod.neoemf : neoemf-utils Optional pom 2.0.0

provided (2)

Group / Artifact Type Version
org.osgi : org.osgi.service.component.annotations jar 1.3.0
com.google.code.findbugs : jsr305 Optional jar 3.0.2

runtime (5)

Group / Artifact Type Version
org.apache.logging.log4j : log4j-core jar 2.11.2
org.apache.logging.log4j : log4j-jul jar 2.11.2
org.apache.logging.log4j : log4j-slf4j-impl jar 2.11.2
org.apache.logging.log4j : log4j-jcl jar 2.11.2
org.apache.logging.log4j : log4j-1.2-api jar 2.11.2

test (6)

Group / Artifact Type Version
org.atlanmod.commons : commons-core test-jar 1.0.4
org.junit.jupiter : junit-jupiter-api jar 5.4.1
org.junit.jupiter : junit-jupiter-params jar 5.4.1
org.junit.jupiter : junit-jupiter-engine jar 5.4.1
org.mockito : mockito-core jar 2.25.1
org.assertj : assertj-core jar 3.12.2

Project Modules

There are no modules declared in this project.

NeoEMF

Build Status CodeCov Codacy Maven Central Javadoc Plugin Licence Javadocs

Check out our wiki for further information on the installation, usages, supported backends, code examples, developer resources, etc.

What Is NeoEMF?

NeoEMF is an AtlanMod research team project that aims at handling large EMF models in an efficient and scalable way.

It is based on our work on Neo4EMF, a scalable and graph-based backend for persisting EMF models.

NeoEMF is a multi-backend framework developped to allow an easy integration of custom backends depending on user needs.

What Are the Features?

NeoEMF comes with some features depending on the backend used:

  • Lazy-loading mechanism: A model is loaded part by part while needed
  • Caching: NeoEMF relies on database caches to retrieve EObjects But in some situation where time performance is important this is not enough and it is possible to use application-level caches to speed up information loading
  • Auto-commit: For the backend having restrictions on transaction sizes it is possible to use the auto-commit feature to split large transaction into several small ones
  • Dirty saving: Handle large models that haven't been persisted to avoid memory overhead

Why Should I Use NeoEMF?

NeoEMF is fully EMF compliant, that means there is no modification to do to use it with existing EMF based applications.

Additionally NeoEMF can be plugged with several persistence solutions and is configurable to fit the best your needs (custom caches, in-memory resources, auto-commit,...).

In addition, NeoEMF provides a query API to perform optimized OCL queries over models and reify the results as navigable models.

Usage

Latest Release

The most recent release is NeoEMF 2.0.0, released March 21, 2019.

To add a dependency on NeoEMF using Maven, use the following:

<dependencies>
  <dependency>
    <groupId>fr.inria.atlanmod.neoemf</groupId>
    <artifactId>neoemf-core</artifactId>
    <version>2.0.0</version>
  </dependency>

  <dependency>
    <groupId>fr.inria.atlanmod.neoemf</groupId>
    <artifactId>neoemf-io</artifactId>
    <version>2.0.0</version>
  </dependency>
</dependencies>

Supported Implementations

All native implementations are located under the neoemf-data artifact. To add the dependency of the specific implementation you want to use, simply use:

<dependency>
  <groupId>fr.inria.atlanmod.neoemf</groupId>
  <artifactId>neoemf-data-{name}</artifactId>
  <version>2.0.0</version>
</dependency>

Where {name} is any of:

  • Blueprints:
    • TinkerGraph : blueprints-core
    • Neo4j: blueprints-neo4j (requires blueprints-core)
  • MapDB : mapdb
  • BerkeleyDB: berkeleydb
  • HBase: hbase
  • MongoDB: mongodb (beta)

Snapshots

Snapshots are automatically build from the master and are available throught Maven using 2.0.1-SNAPSHOT.

Installation

Dedicated pages are available in our wiki for the installation and the build.

Update Site

The simplest way to install NeoEMF is to use the update-site that is available here. Install the NeoEMF Persistence Framework component, which provides NeoEMF core classes and utils. Select the backend specific implementation(s) you want to plug in NeoEMF.

Local Build

You can build locally NeoEMF by following the instructions in the Build section. It is then possible to install NeoEMF from the local built update-site, or by importing the generated plugins.

Benchmarks

A full benchmarks description is available at here.

Issues

If you experience issues installing or using NeoEMF, you can submit an issue on github or contact us at [email protected]

Known issues:

  • Only Oxygen plugins are fetched (the compatibility is not ensured for previous Eclipse versions)
  • The Eclipse plugins can not be built if Maven can not access internet (it is needed to fetch Oxygen p2 repositories)
  • Sometimes the plugin build crashes and/or freezes during p2 index fetching from Oxygen repositories. It is generally sufficient to cancel the build (ctrl-c) and to relaunch it.

Credits

Performance problems and memory leaks are diagnosed with Java Profiler

fr.inria.atlanmod.neoemf

Atlanmod

(IMT-Atlantique, LS2N)

Versions

Version
2.0.0
1.0.2
1.0.1
1.0.0