Jump to: navigation, search

Difference between revisions of "CDO/Hibernate Store/Tutorial"

(Download the example projects from CVS)
Line 14: Line 14:
 
[[Image:org.eclipse.emf.cdo.hibernate.project_explorer.png|center|200px]]
 
[[Image:org.eclipse.emf.cdo.hibernate.project_explorer.png|center|200px]]
  
 +
== Details of the example projects ==
  
 
Before continuing take some time to study the projects.
 
Before continuing take some time to study the projects.
  
The org.eclipse.emf.cdo.examples.company project contains the model. Instances of this model will be persisted. The model has been [[Preparing_EMF_Models_for_CDO|prepared]] for CDO. The interfaces inherit from CDOObject and the impl classes from CDOObjectImpl.  
+
The ''org.eclipse.emf.cdo.examples.company'' project contains the model. Instances of this model will be persisted. The model has been [[Preparing_EMF_Models_for_CDO|prepared]] for CDO. The interfaces inherit from CDOObject and the impl classes from CDOObjectImpl.  
  
The org.eclipse.emf.cdo.examples.hibernate.server project contains the server side configuration files. This plugin is used on the server, it has been added to the launch configuration of the server. The org.eclipse.emf.cdo.examples.hibernate.server project contains a number of important files:
+
The org.eclipse.emf.cdo.examples.hibernate.server project contains the server side configuration files. This plugin is used on the server, it has been added to the launch configuration of the server. The ''org.eclipse.emf.cdo.examples.hibernate.server'' project contains a number of important files:
 
* config/cdo-server.xml: the CDO server config file, for more information see the [[CDO_Hibernate_Store_Configuration_and_Setup#Configuration_file|configuration]] page
 
* config/cdo-server.xml: the CDO server config file, for more information see the [[CDO_Hibernate_Store_Configuration_and_Setup#Configuration_file|configuration]] page
 
* META-INF/company_model_teneo_annotations.xml: contains [[CDO_Hibernate_Store_Model_Relational_Mapping#JPA_Annotations_in_XML|JPA annotations]] which control how the model is mapped to the database. In this case there is only a simple annotation which controls the table name of the Address EClas.
 
* META-INF/company_model_teneo_annotations.xml: contains [[CDO_Hibernate_Store_Model_Relational_Mapping#JPA_Annotations_in_XML|JPA annotations]] which control how the model is mapped to the database. In this case there is only a simple annotation which controls the table name of the Address EClas.
 
* META-INF/MANIFEST.MF: the plugin has been set to depend on org.eclipse.emf.cdo.server.hibernate.teneo, using the Eclipse buddy loading policy this makes the annotations xml file visible for the Hibernate/Teneo plugins
 
* META-INF/MANIFEST.MF: the plugin has been set to depend on org.eclipse.emf.cdo.server.hibernate.teneo, using the Eclipse buddy loading policy this makes the annotations xml file visible for the Hibernate/Teneo plugins
  
 +
The org.eclipse.emf.cdo.examples.hibernate.client project contains the client side code. The actual runnable code consists of 2 test cases. Both test cases extend from BaseTest which contains the client-server connection code. The test cases are discussed in more detail below.
  
 
== Start the CDO Server ==
 
== Start the CDO Server ==
  
The
+
As a next step, start the CDO server. To do this right click on the CDOHibernateServer.launch and do: Run As > CDOHibernateServer. This launch configuration loads all plugins in the Eclipse installation and workspace so it takes some time to start the CDO server (around 10 seconds).
  
  
 
----
 
----
 
Wikis: [[CDO]] | [[Net4j]] | [[EMF]] | [[Eclipse]]
 
Wikis: [[CDO]] | [[Net4j]] | [[EMF]] | [[Eclipse]]

Revision as of 18:15, 21 January 2010

_

This tutorial assumes that the required dependencies are installed.

Download the example projects from CVS

As a first step download the example projects from CVS, see here for the CVS location information.

After downloading it is possible that you need to clean all the projects, goto Project > Clean (and clean all projects). The projects should not show any error messages.

After performing the above steps the Project Explorer should look like this:


Org.eclipse.emf.cdo.hibernate.project explorer.png

Details of the example projects

Before continuing take some time to study the projects.

The org.eclipse.emf.cdo.examples.company project contains the model. Instances of this model will be persisted. The model has been prepared for CDO. The interfaces inherit from CDOObject and the impl classes from CDOObjectImpl.

The org.eclipse.emf.cdo.examples.hibernate.server project contains the server side configuration files. This plugin is used on the server, it has been added to the launch configuration of the server. The org.eclipse.emf.cdo.examples.hibernate.server project contains a number of important files:

  • config/cdo-server.xml: the CDO server config file, for more information see the configuration page
  • META-INF/company_model_teneo_annotations.xml: contains JPA annotations which control how the model is mapped to the database. In this case there is only a simple annotation which controls the table name of the Address EClas.
  • META-INF/MANIFEST.MF: the plugin has been set to depend on org.eclipse.emf.cdo.server.hibernate.teneo, using the Eclipse buddy loading policy this makes the annotations xml file visible for the Hibernate/Teneo plugins

The org.eclipse.emf.cdo.examples.hibernate.client project contains the client side code. The actual runnable code consists of 2 test cases. Both test cases extend from BaseTest which contains the client-server connection code. The test cases are discussed in more detail below.

Start the CDO Server

As a next step, start the CDO server. To do this right click on the CDOHibernateServer.launch and do: Run As > CDOHibernateServer. This launch configuration loads all plugins in the Eclipse installation and workspace so it takes some time to start the CDO server (around 10 seconds).



Wikis: CDO | Net4j | EMF | Eclipse