Teneo

From Eclipsepedia

Jump to: navigation, search

Contents


EMF & ORM: Teneo is a Model-Relational mapping and runtime database persistence solution for the Eclipse Modeling Framework (EMF). Teneo integrates EMF with both Hibernate and EclipseLink.

Web-service/Web-application: If you want to work with EMF in a web environment or connect your RCP to a standard JPA web-server, consider using the EMFT Texo project, for more information see the Texo wiki.

RCP: if you want to develop a RCP with less emphasys on custom server side logic consider using CDO. Teneo is used for Model Relational mapping within the CDO Hibernate Store.

RCP connected to a JPA compliant server: if you want to connect your RCP to a standards compliant JPA (web-)server consider using the EMFT Texo project, for more information see the Texo wiki.

Features

  • Powerful Tool Combination: Teneo integrates EMF with existing persistency solutions, combining strong model-driven code generation functionality with the power of storage, caching and querying of sophisticated object-relational mapping and persistency software.
  • Flexible Approach: Teneo automatically maps models to relational database schema. The mapping can be fully controlled, overridden and extended with JPA annotations in the model itself or in a separate xml file.
  • Extensive Coverage: Teneo supports persistence of virtually every ecore model out-of-the-box without additional manual mapping work.
  • Server-Side-Solutions: Teneo is primarily for server-oriented environments with business logic running on the server. Especially web-service solutions can benefit from the EMF XML (de-) serialization support combined with automatic Model-Relational mapping and runtime database persistence.

Documentation

For detailed information, manuals and tutorials for each solution visit the ORM specific part of the site:

  • Hibernate: The EMF - Hibernate integration supports persisting of basic EObjects, ELists with 1:n, n:m, one-way, two-way and contained relations. EMF Objects can be retrieved using HQL queries. For more information see here
  • EclipseLink: The EMF - EclipseLink integration is a fully JPA compliant solution using the EclipseLink orm tool. For more information see here

Versions

Teneo supports the three current EMF versions:

  • EMF 2.5 (Eclipse 3.5): for this EMF version the Teneo builds numbered 1.1.2 should be used.
  • EMF 2.6 (Eclipse 3.6): for this EMF version the Teneo builds numbered 1.2.0 should be used.
  • EMF 2.7 (Eclipse 3.7): for this EMF version the Teneo builds numbered 1.2.0 or 2.0.0 can be used.
  • EMF 2.8 (Eclipse 3.8): for this EMF version the Teneo builds numbered 2.0.0 should be used.

Currently (May 2012) development takes place on Teneo 2.0 which will support EMF 2.8 (Eclipse 4), and is backward compatible with EMF 2.7.

GIT, Support, Commit Mailing List and FAQ

The Teneo source code is stored in git in this location:

org.eclipse.emf.teneo.git (browse, stats, fork on OrionHub)

If you encounter issues, check the FAQ page.

Support for Teneo is given on the EMF newsgroup. For accessing the news group through a browser visit this page. To read newsgroups using a client application, install Pan Newsreader (pan Debian/Ubuntu package) or KNode (knode Debian/Ubuntu package).

To subscribe to the commit mailing list, visit this page: https://dev.eclipse.org/mailman/listinfo/teneo-commit

Before November 2011, source code was stored in cvs, the cvs repository has been converted to git, for your reference you can find the archived cvs repository here.

Continuous Build

Teneo is build using Buckminster and Hudson in a continuous build system.

Update site containing the latest successful nightly builds: https://hudson.eclipse.org/hudson/job/emf-teneo-nightly/lastSuccessfulBuild/artifact/build/result/p2site/