Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Teneo"

(GIT, Support, Commit Mailing List and FAQ)
(47 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Teneo is a Model-Relational mapping and runtime database persistence solution for the [http://www.eclipse.org/emf Eclipse Modeling Framework] (EMF). Teneo is part of the Eclipse Modeling Framework and as such can be found on the main
+
__TOC__
[http://www.eclipse.org/modeling/emf/?project=teneo EMF] project page also. Teneo is also used as a mapping component within the [[CDO|CDO]] project, Teneo is used for the Model-Relational mapping within the [[CDO_Hibernate_Store|CDO Hibernate Store]].
+
  
Teneo with EMF is particularly well-suited for use in '''server oriented model-driven web-service and web application environments'''.
+
'''EMF & ORM''': Teneo is a Model-Relational mapping and runtime database persistence solution for the [http://www.eclipse.org/emf Eclipse Modeling Framework] (EMF). Teneo integrates EMF with both [http://www.hibernate.org Hibernate] and [http://www.eclipse.org/eclipselink EclipseLink].
  
Teneo benefits:
+
'''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|Texo wiki]].
  
* '''Powerfull''': Teneo integrates EMF with existing persistency solutions, combining the power of a code generation framework like EMF and the power of storage, caching and querying of sophisticated object-relational mapping and persistency software.
+
'''RCP''': if you want to develop a RCP with less emphasys on custom server side logic consider using [[CDO|CDO]]. Teneo is used for Model Relational mapping within the [[CDO_Hibernate_Store|CDO Hibernate Store]].
  
* '''Flexible''': 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.
+
'''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|Texo wiki]].  
  
* '''Extensive''': Teneo supports persistence of virtually every ecore model out-of-the-box without additional manual mapping work.
+
==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.
  
* '''Server-Side-Solutions''': Teneo is primarily for (web-)server environments. 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:
 +
* '''[[Teneo/Hibernate|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 [[Teneo/Hibernate|here]]
 +
* '''[[Teneo/EclipseLink|EclipseLink]]''': The EMF - EclipseLink integration is a fully JPA compliant solution using the EclipseLink orm tool. For more information see [[Teneo/EclipseLink|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.
  
Teneo integrates EMF with both [http://www.hibernate.org Hibernate] and [http://www.eclipse.org/eclipselink EclipseLink]. For detailed information, manuals and tutorials for each solution visit the ORM specific part of the site:
+
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.
  
* '''[[Teneo/Hibernate|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 [[Teneo/Hibernate|here]]
+
== GIT, Support, Commit Mailing List and FAQ ==
  
* '''[[EMF/Teneo/EclipseLink_JPA|EclipseLink]]''': The EMF - EclipseLink integration is a fully JPA compliant solution using the EclipseLink orm tool. For more information see [[EMF/Teneo/EclipseLink_JPA|here]]
+
The Teneo source code is stored in git in this location:
  
 +
{{Git|teneo|org.eclipse.emf.teneo.git}}
 +
If you encounter issues, check the [[Teneo/Hibernate/FAQ|FAQ]] page.
  
Teneo supports the three current EMF versions:
+
Support for Teneo is given on the [http://www.eclipse.org/modeling/emf/newsgroup-mailing-list.php EMF newsgroup]. For accessing the news group through a browser visit this [http://www.eclipse.org/forums/eclipse.tools.emf page]. To read newsgroups using a client application, install [http://pan.rebelbase.com/ Pan Newsreader] (<tt>pan</tt> Debian/Ubuntu package) or [http://knode.sourceforge.net/ KNode] (<tt>knode</tt> Debian/Ubuntu package).
  
* EMF 2.4 (Eclipse 3.4): for this EMF version the Teneo release numbered 1.0.* (current maintenance build is 1.0.4) should be used.
+
To subscribe to the commit mailing list, visit this page: https://dev.eclipse.org/mailman/listinfo/teneo-commit
* EMF 2.5 (Eclipse 3.5): for this EMF version the Teneo builds numbered 1.1.0/1.1.1/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.
+
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 [http://archive.eclipse.org/modeling/emf/teneo/teneo_cvs.tgz here].
 +
 
 +
== Continuous Build ==
 +
 
 +
Teneo is build using [[Buckminster|Buckminster]] and [[Hudson|Hudson]] in a continuous build system.
 +
 
 +
* [https://hudson.eclipse.org/hudson/job/emf-teneo-nightly/ Teneo nightly build job]
 +
* Detailed description on  [[Teneo/Teneo_Build_Setup|Teneo's build setup]]
 +
 
 +
Update site containing the latest successful nightly builds:
 +
https://hudson.eclipse.org/hudson/job/emf-teneo-nightly/lastSuccessfulBuild/artifact/build/result/p2site/
 +
 
 +
[[Category:Teneo]][[Category:EMF]][[Category:Hibernate]]

Revision as of 03:12, 1 October 2012

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/

Back to the top