Jump to: navigation, search

Difference between revisions of "JPA Diagram Editor Project"

m (Overview)
m
(24 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
== Overview  ==
 
== Overview  ==
  
The JPA Diagram Editor project enables the JPA developers to create, view, and edit their business data model as graphical diagram. Currently, this is a [http://eclipse.org/webtools/incubator/ WTP incubator] project. For detailed information, see the [http://wiki.eclipse.org/WTP/JPA_Diagram_Editor/Proposal project proposal].
+
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 [http://wiki.eclipse.org/WTP/JPA_Diagram_Editor/Proposal 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  ==
 
== 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.
 +
 
 +
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.
  
 
<br>Bugzilla bookkeeping:  
 
<br>Bugzilla bookkeeping:  
  
*[https://bugs.eclipse.org/bugs/buglist.cgi?classification=WebTools;query_based_on=JPA%20Editor;query_format=advanced;bug_status=UNCONFIRMED;bug_status=NEW;bug_status=ASSIGNED;bug_status=REOPENED;component=wtp.inc.jpaeditor;target_milestone=---;product=WTP%20Incubator;known_name=JPA%20Editor Untargeted open bugs]  
+
*[https://bugs.eclipse.org/bugs/buglist.cgi?classification=WebTools;query_based_on=JPA%20Editor;query_format=advanced;bug_status=UNCONFIRMED;bug_status=NEW;bug_status=ASSIGNED;bug_status=REOPENED;component=Diagram%20Editor;target_milestone=---;product=Dali%20JPA%20Tools;known_name=JPA%20Editor Untargeted open bugs]  
*[https://bugs.eclipse.org/bugs/buglist.cgi?classification=WebTools;query_based_on=JPA%20Editor;emailtype1=exact;query_format=advanced;emailassigned_to1=1;bug_status=UNCONFIRMED;bug_status=NEW;bug_status=ASSIGNED;bug_status=REOPENED;email1=wtp.inc.jpaeditor-inbox%40eclipse.org;component=wtp.inc.jpaeditor;product=WTP%20Incubator;known_name=JPA%20Editor Unassigned open bugs]  
+
*[https://bugs.eclipse.org/bugs/buglist.cgi?classification=WebTools;query_based_on=JPA%20Editor;emailtype1=exact;emailassigned_to1=1;query_format=advanced;bug_status=UNCONFIRMED;bug_status=NEW;bug_status=ASSIGNED;bug_status=REOPENED;email1=dali.diagrameditor-inbox%40eclipse.org;component=Diagram%20Editor;product=Dali%20JPA%20Tools;known_name=JPA%20Editor Unassigned open bugs]  
*[https://bugs.eclipse.org/bugs/buglist.cgi?classification=WebTools&query_based_on=JPA%20Editor&query_format=advanced&bug_status=RESOLVED&component=wtp.inc.jpaeditor&product=WTP%20Incubator&known_name=JPA%20Editor Resolved bugs, but not verified]  
+
*[https://bugs.eclipse.org/bugs/buglist.cgi?classification=WebTools;query_based_on=JPA%20Editor;query_format=advanced;bug_status=RESOLVED;component=Diagram%20Editor;product=Dali%20JPA%20Tools;known_name=JPA%20Editor Resolved bugs, but not verified]  
*[https://bugs.eclipse.org/bugs/buglist.cgi?classification=WebTools;query_based_on=JPA%20Editor;query_format=advanced;bug_status=VERIFIED;component=wtp.inc.jpaeditor;product=WTP%20Incubator;known_name=JPA%20Editor Verified bugs, but not closed]
+
*[https://bugs.eclipse.org/bugs/buglist.cgi?classification=WebTools;query_based_on=JPA%20Editor;query_format=advanced;bug_status=VERIFIED;component=Diagram%20Editor;product=Dali%20JPA%20Tools;known_name=JPA%20Editor Verified bugs, but not closed]
  
 
== How to Install  ==
 
== How to Install  ==
  
 
[[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 37: 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=WTP%20Incubator&component=wtp.inc.jpaeditor Report bugs in Bugzilla], component '''wtp.inc.jpaeditor'''
+
[https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Dali%20JPA%20Tools&component=Diagram%20Editor Report bugs in Bugzilla]
 
+
*[https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;component=wtp.inc.jpaeditor;product=WTP%20Incubator;classification=WebTools Known bugs]
+
  
 
== 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''':/incubator/org.eclipse.jpt/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.inc-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.inc-jpaeditor/lastSuccessfulBuild/artifact/targetPlatform/ P2 repository of the latest build]  
+
[https://hudson.eclipse.org/hudson/view/WTP/job/cbi-wtp.jpaeditor/lastSuccessfulBuild/artifact/targetPlatform/ 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

Revision as of 02:37, 30 October 2012

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