Jump to: navigation, search

Difference between revisions of "JPA Diagram Editor Project"

m
 
(15 intermediate revisions by 3 users not shown)
Line 7: Line 7:
 
== Project Status  ==
 
== Project Status  ==
  
First official release (0.5) is a fact! See the next section for installation instructions. 
+
JPA Diagram editor is a component of Dali. It's part of the Indigo and later releases of the eclipse. It's also compatible with Helios.
  
 
JPA diagram editor offers full support for JPA 1.0. JPA 2.0 support development is in progress as well as support of additional JPA artifacts like embeddable classes and mapped superclasses.  
 
JPA diagram editor offers full support for JPA 1.0. JPA 2.0 support development is in progress as well as support of additional JPA artifacts like embeddable classes and mapped superclasses.  
Line 13: Line 13:
 
The editor already supports the new (JPA 2.0) style One-to-Many unidirectional relationship. I.e. - in JPA 2.0 projects the corresponding relationship attribute will be created with additional @JoinColumn(s) annotation, which means that the corresponding DB schema will be created without additional join table.
 
The editor already supports the new (JPA 2.0) style One-to-Many unidirectional relationship. I.e. - in JPA 2.0 projects the corresponding relationship attribute will be created with additional @JoinColumn(s) annotation, which means that the corresponding DB schema will be created without additional join table.
  
This beahvior is optional. The user may choose from the editor preference page or project property page to create this relationship (in JPA 2.0 projects) compliant with JPA 1.0 specification, i.e. - without the additional @JoinColumn(s) annotation.
+
This behavior is optional. The user may choose from the editor preference page or project property page to create this relationship (in JPA 2.0 projects) compliant with JPA 1.0 specification, i.e. - without the additional @JoinColumn(s) annotation.
  
 
<br>Bugzilla bookkeeping:  
 
<br>Bugzilla bookkeeping:  
Line 25: Line 25:
  
 
[[Image:JPA Editor P2 Repo.png|thumb]]  
 
[[Image:JPA Editor P2 Repo.png|thumb]]  
 +
 +
If you are using Indigo or greater eclipse versions you may skip this section
  
 
Download and extract [http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/helios/R/eclipse-jee-helios-win32.zip Eclipse for Java EE Developers Helios].  
 
Download and extract [http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/helios/R/eclipse-jee-helios-win32.zip Eclipse for Java EE Developers Helios].  
Line 45: Line 47:
 
== Where I can get help and information?  ==
 
== Where I can get help and information?  ==
  
[http://www.eclipse.org/forums/index.php?t=thread&frm_id=114 WTP Incubator Forum]  
+
[http://www.eclipse.org/forums/index.php/f/113/ Dali Forum]  
  
[https://dev.eclipse.org/mailman/listinfo/wtp-incubator-dev WTP Incubator Dev mailing list]  
+
[https://dev.eclipse.org/mailman/listinfo/dali-dev Dali Dev mailing list]  
  
 
[https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Dali%20JPA%20Tools&component=Diagram%20Editor Report bugs in Bugzilla]
 
[https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Dali%20JPA%20Tools&component=Diagram%20Editor Report bugs in Bugzilla]
Line 53: Line 55:
 
== How do I get sources?  ==
 
== How do I get sources?  ==
  
The source code is in the following CVS repository:  
+
The source code is in the following GIT repository:  
  
''':pserver:anonymous@dev.eclipse.org/cvsroot/webtools'''
+
git://git.eclipse.org/gitroot/dali/webtools.dali.git
  
'''HEAD''':/org.eclipse.jpa/components/jpa_diagram_editor/plugins/org.eclipse.jpt.ui.diagrameditor
+
ssh://git.eclipse.org/gitroot/dali/webtools.dali.git
  
See the [[CVS Howto]] for help using CVS.  
+
http://git.eclipse.org/gitroot/dali/webtools.dali.git
 +
 
 +
'''master''':/jpa_diagram_editor/plugins/org.eclipse.jpt.ui.diagrameditor
 +
 
 +
See the [http://wiki.eclipse.org/EGit/User_Guide EGit User Guide] for help using EGit.  
  
 
== Build Infrastructure  ==
 
== Build Infrastructure  ==
  
The build is based on Maven+Tycho, executed on [[Hudson]] server, hosted at Eclipse Foundation. New build is triggered automatically after a change submitted in CVS.  
+
The build is based on Maven+Tycho, executed on [[Hudson]] server, hosted at Eclipse Foundation. New build is triggered automatically after a change committed in GIT.  
  
 
[https://hudson.eclipse.org/hudson/view/WTP/job/cbi-wtp.jpaeditor/ Hudson build job]  
 
[https://hudson.eclipse.org/hudson/view/WTP/job/cbi-wtp.jpaeditor/ Hudson build job]  
  
[https://hudson.eclipse.org/hudson/view/WTP/job/cbi-wtp.jpaeditor/lastSuccessfulBuild/artifact/targetPlatform/ P2 repository of the latest build]
+
[https://hudson.eclipse.org/hudson/view/WTP/job/cbi-wtp.jpaeditor/lastSuccessfulBuild/artifact/jpa_diagram_editor/development/org.eclipse.jpt.jpadiagrameditor.repository/target/repository/ P2 repository of the latest build]
  
== Known Problems  ==
+
== Limitations ==
  
 
*Registering of JPA entities in persistence.xml causes inconsistent editor behavior – Eclipse bug #[https://bugs.eclipse.org/bugs/show_bug.cgi?id=257530 257530]
 
*Registering of JPA entities in persistence.xml causes inconsistent editor behavior – Eclipse bug #[https://bugs.eclipse.org/bugs/show_bug.cgi?id=257530 257530]
  
 
*Refactoring entity class (from outside the diagram editor) causes disappearing of the corresponding pictogram from the diagram - Eclipse bug #[https://bugs.eclipse.org/bugs/show_bug.cgi?id=324026 324026]
 
*Refactoring entity class (from outside the diagram editor) causes disappearing of the corresponding pictogram from the diagram - Eclipse bug #[https://bugs.eclipse.org/bugs/show_bug.cgi?id=324026 324026]
 +
 +
*Currently only pure Java entities are supported. There is no mapping XML entities support yet.
 +
 +
*Still no support for Undo/Redo - Eclipse bug #[https://bugs.eclipse.org/bugs/show_bug.cgi?id=345322 345322]

Latest revision as of 07:35, 10 April 2013

Overview

The JPA Diagram Editor enables the JPA developers to create, view, and edit their business data model as graphical diagram. For detailed information, see the project proposal.

The JPA Diagram Editor recently passed successfully a Move Review. The code and the infrastructure of the project was successfully moved from the WTP Incubator to the WTP Dali project.

Project Status

JPA Diagram editor is a component of Dali. It's part of the Indigo and later releases of the eclipse. It's also compatible with Helios.

JPA diagram editor offers full support for JPA 1.0. JPA 2.0 support development is in progress as well as support of additional JPA artifacts like embeddable classes and mapped superclasses.

The editor already supports the new (JPA 2.0) style One-to-Many unidirectional relationship. I.e. - in JPA 2.0 projects the corresponding relationship attribute will be created with additional @JoinColumn(s) annotation, which means that the corresponding DB schema will be created without additional join table.

This behavior is optional. The user may choose from the editor preference page or project property page to create this relationship (in JPA 2.0 projects) compliant with JPA 1.0 specification, i.e. - without the additional @JoinColumn(s) annotation.


Bugzilla bookkeeping:

How to Install

JPA Editor P2 Repo.png

If you are using Indigo or greater eclipse versions you may skip this section

Download and extract Eclipse for Java EE Developers Helios.

Start the Eclipse IDE.

Install the project:

  1. Go to Help -> Install New Software.
  2. Paste the following URL in the Works with field and hit Enter: http://download.eclipse.org/webtools/incubator/repository/jpaeditor/helios/
  3. You need to select only the features from the JPA Diagram Editor category. The install manager will automatically pick-up the necessary Graphiti features.
  4. Follow the next steps of the wizard to install it.

Using the JPA Diagram Editor 

Getting Started Tutorial

Watch demo on YouTube

Where I can get help and information?

Dali Forum

Dali Dev mailing list

Report bugs in Bugzilla

How do I get sources?

The source code is in the following GIT repository:

git://git.eclipse.org/gitroot/dali/webtools.dali.git

ssh://git.eclipse.org/gitroot/dali/webtools.dali.git

http://git.eclipse.org/gitroot/dali/webtools.dali.git

master:/jpa_diagram_editor/plugins/org.eclipse.jpt.ui.diagrameditor

See the EGit User Guide for help using EGit.

Build Infrastructure

The build is based on Maven+Tycho, executed on Hudson server, hosted at Eclipse Foundation. New build is triggered automatically after a change committed in GIT.

Hudson build job

P2 repository of the latest build

Limitations

  • Registering of JPA entities in persistence.xml causes inconsistent editor behavior – Eclipse bug #257530
  • Refactoring entity class (from outside the diagram editor) causes disappearing of the corresponding pictogram from the diagram - Eclipse bug #324026
  • Currently only pure Java entities are supported. There is no mapping XML entities support yet.
  • Still no support for Undo/Redo - Eclipse bug #345322