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 "New Help for Old Friends IX"

(→‎JPA Core (Provisional API))
(→‎JPA Core (Provisional API))
Line 42: Line 42:
 
** added method <code>sortClasses()</code>
 
** added method <code>sortClasses()</code>
  
−
* reworked the API for converting mapping relationship settings so it is more clear what types of objects are converted to and from:
+
* Renamed <code>JpaContextModelRoot</code> to <code>JpaContextRoot</code> and related changes:
−
** <code>OverrideRelationship</code>
+
** renamed <code>JpaContextModelRoot2_0</code> to <code>JpaContextRoot2_0</code>
−
*** removed method <code>initializeOnSpecified(SpecifiedOverrideRelationship)</code>
+
** <code>JpaFactory</code>
−
** <code>Relationship</code>
+
*** renamed <code>buildContextModelRoot(JpaProject)</code> to <code>buildContextRoot(JpaProject)</code>
−
*** removed method <code>initializeOn(SpecifiedRelationship)</code>
+
** <code>JpaProject</code>
−
** <code>SpecifiedAssociationOverride</code>
+
*** renamed <code>getContextModelRoot()</code> to <code>getContextRoot()</code>
−
*** removed method <code>initializeFrom(AssociationOverride)</code>
+
*** renamed <code>CONTEXT_MODEL_ROOT_TRANSFORMER</code> to <code>CONTEXT_ROOT_TRANSFORMER</code>
−
*** removed method <code>initializeFromVirtual(AssociationOverride)</code>
+
*** renamed <code>ContextModelRootTransformer</code> to <code>ContextRootTransformer</code>
−
** <code>SpecifiedAttributeOverride</code>
+
 
−
*** removed method <code>initializeFrom(AttributeOverride)</code>
+
* Reworked the API for converting mapping relationship settings so it is more clear what types of objects are converted to and from. Specifically:
−
*** removed method <code>initializeFromVirtual(AttributeOverride)</code>
+
** Only ''ORM'' specified mapping relationship settings are copied over, when an an ORM attribute mapping is converted to another mapping (In Java, the annotations are simply left in place and rediscovered when the new mapping annotation is added to the source file.):
−
** <code>SpecifiedColumn</code>
+
*** <code>SpecifiedAssociationOverride</code>
−
*** added method <code>initializeFrom(VirtualColumn)</code>
+
**** removed method <code>initializeFrom(AssociationOverride)</code>
−
** <code>SpecifiedJoinColumn</code>
+
**** removed method <code>initializeFromVirtual(AssociationOverride)</code>
−
*** added method <code>initializeFrom(VirtualJoinColumn)</code>
+
*** <code>SpecifiedAttributeOverride</code>
−
*** removed method <code>initializeFrom(JoinColumn)</code>
+
**** removed method <code>initializeFrom(AttributeOverride)</code>
−
*** removed method <code>initializeFromVirtual(JoinColumn)</code>
+
**** removed method <code>initializeFromVirtual(AttributeOverride)</code>
−
** <code>SpecifiedJoinColumnRelationshipStrategy</code>
+
*** <code>OrmSpecifiedAttributeOverride</code>
−
*** added method <code>initializeFrom(VirtualJoinColumnRelationshipStrategy)</code>
+
**** added method <code>initializeFrom(OrmSpecifiedAttributeOverride)</code>
−
*** removed method <code>initializeFrom(JoinColumnRelationshipStrategy)</code>
+
*** <code>Relationship</code>
−
*** removed method <code>initializeFromVirtual(JoinColumnRelationshipStrategy)</code>
+
**** removed method <code>initializeOn(SpecifiedRelationship)</code>
−
** <code>SpecifiedJoinTable</code>
+
*** <code>OrmMappingRelationship</code>
−
*** added method <code>initializeFrom(VirtualJoinTable)</code>
+
**** added method <code>initializeFrom(OrmMappingRelationship)</code>
−
*** removed method <code>initializeFrom(JoinTable)</code>
+
**** added method <code>initializeOn(OrmMappingRelationship)</code>
−
*** removed method <code>initializeFromVirtual(JoinTable)</code>
+
**** added method <code>initializeFromJoinColumnRelationship(OrmJoinColumnRelationship)</code>
−
** <code>SpecifiedJoinTableRelationshipStrategy</code>
+
**** added method <code>initializeFromJoinTableRelationship(OrmJoinTableRelationship)</code>
−
*** added method <code>initializeFrom(VirtualJoinTableRelationshipStrategy)</code>
+
**** added method <code>initializeFromMappedByRelationship(OrmMappedByRelationship)</code>
−
*** removed method <code>initializeFrom(JoinTableRelationshipStrategy)</code>
+
**** added method <code>initializeFromPrimaryKeyJoinColumnRelationship(OrmPrimaryKeyJoinColumnRelationship)</code>
−
*** removed method <code>initializeFromVirtual(JoinTableRelationshipStrategy)</code>
+
*** <code>OverrideRelationship</code>
−
** <code>SpecifiedMappedByRelationshipStrategy</code>
+
**** removed method <code>initializeOnSpecified(SpecifiedOverrideRelationship)</code>
−
*** removed method <code>initializeFrom(SpecifiedMappedByRelationshipStrategy)</code>
+
*** <code>OrmMappedByRelationship</code>
−
** <code>SpecifiedOverrideRelationship</code>
+
**** added method <code>getMappedByStrategy()</code>
−
*** added method <code>initializeFrom(VirtualOverrideRelationship)</code>
+
*** <code>SpecifiedJoinColumnRelationshipStrategy</code>
−
*** removed method <code>initializeFromVirtual(OverrideRelationship)</code>
+
**** removed method <code>initializeFrom(JoinColumnRelationshipStrategy)</code>
−
*** removed method <code>initializeFromVirtualJoinColumnRelationship(JoinColumnRelationship)</code>
+
*** <code>OrmSpecifiedJoinColumnRelationshipStrategy</code>
−
*** removed method <code>initializeFromVirtualJoinTableRelationship(JoinTableRelationship)</code>
+
**** added method <code>initializeFrom(OrmSpecifiedJoinColumnRelationshipStrategy)</code>
−
** <code>JavaSpecifiedAssociationOverride</code>
+
*** <code>SpecifiedJoinTableRelationshipStrategy</code>
−
*** added method <code>initializeFrom(JavaVirtualAssociationOverride)</code>
+
**** removed method <code>initializeFrom(JoinTableRelationshipStrategy)</code>
−
** <code>JavaSpecifiedAttributeOverride</code>
+
*** <code>OrmSpecifiedJoinTableRelationshipStrategy</code>
−
*** added method <code>initializeFrom(JavaVirtualAttributeOverride)</code>
+
**** added method <code>initializeFrom(OrmSpecifiedJoinTableRelationshipStrategy)</code>
−
** <code>OrmMappedByRelationship</code>
+
*** <code>SpecifiedMappedByRelationshipStrategy</code>
−
*** added method <code>getMappedByStrategy()</code>
+
**** removed method <code>initializeFrom(SpecifiedMappedByRelationshipStrategy)</code>
−
** <code>OrmMappingRelationship</code>
+
*** <code>OrmSpecifiedMappedByRelationshipStrategy</code>
−
*** added method <code>initializeFrom(OrmMappingRelationship)</code>
+
**** added method <code>initializeFrom(OrmSpecifiedMappedByRelationshipStrategy)</code>
−
*** added method <code>initializeOn(OrmMappingRelationship)</code>
+
*** <code>OrmSpecifiedPrimaryKeyJoinColumnRelationshipStrategy</code>
−
*** added method <code>initializeFromJoinColumnRelationship(OrmJoinColumnRelationship)</code>
+
**** added method <code>initializeFrom(OrmSpecifiedPrimaryKeyJoinColumnRelationshipStrategy)</code>
−
*** added method <code>initializeFromJoinTableRelationship(OrmJoinTableRelationship)</code>
+
*** <code>SpecifiedJoinTable</code>
−
*** added method <code>initializeFromMappedByRelationship(OrmMappedByRelationship)</code>
+
**** removed method <code>initializeFrom(JoinTable)</code>
−
*** added method <code>initializeFromPrimaryKeyJoinColumnRelationship(OrmPrimaryKeyJoinColumnRelationship)</code>
+
*** <code>OrmSpecifiedJoinTable</code>
−
** <code>OrmSpecifiedAssociationOverride</code>
+
**** added method <code>initializeFrom(OrmSpecifiedJoinTable)</code>
−
*** added method <code>initializeFrom(OrmVirtualAssociationOverride)</code>
+
*** <code>OrmSpecifiedColumn</code>
−
** <code>OrmSpecifiedAttributeOverride</code>
+
**** added method <code>initializeFrom(OrmSpecifiedColumn)</code>
−
*** added method <code>initializeFrom(OrmVirtualAttributeOverride)</code>
+
*** <code>SpecifiedJoinColumn</code>
−
*** added method <code>initializeFrom(OrmSpecifiedAttributeOverride)</code>
+
**** removed method <code>initializeFrom(JoinColumn)</code>
−
** <code>OrmSpecifiedColumn</code>
+
*** <code>OrmSpecifiedJoinColumn</code>
−
*** added method <code>initializeFrom(OrmSpecifiedColumn)</code>
+
**** added method <code>initializeFrom(OrmSpecifiedJoinColumn)</code>
−
** <code>OrmSpecifiedJoinColumn</code>
+
*** <code>OrmSpecifiedPrimaryKeyJoinColumn</code>
−
*** added method <code>initializeFrom(OrmSpecifiedJoinColumn)</code>
+
**** removed method <code>initializeFrom(PrimaryKeyJoinColumn)</code>
−
** <code>OrmSpecifiedJoinColumnRelationshipStrategy</code>
+
**** added method <code>initializeFrom(OrmSpecifiedPrimaryKeyJoinColumn)</code>
−
*** added method <code>initializeFrom(OrmSpecifiedJoinColumnRelationshipStrategy)</code>
+
*** <code>OrmSpecifiedSecondaryTable</code>
−
** <code>OrmSpecifiedJoinTable</code>
+
**** removed method <code>initializeFrom(SecondaryTable)</code>
−
*** added method <code>initializeFrom(OrmSpecifiedJoinTable)</code>
+
*** <code>OrmCollectionTable2_0</code>
−
** <code>OrmSpecifiedJoinTableRelationshipStrategy</code>
+
**** removed method <code>initializeFrom(CollectionTable2_0)</code>
−
*** added method <code>initializeFrom(OrmSpecifiedJoinTableRelationshipStrategy)</code>
+
**** added method <code>initializeFrom(OrmCollectionTable2_0)</code>
−
** <code>OrmSpecifiedMappedByRelationshipStrategy</code>
+
** Virtual Java override relationship settings are copied only to a specified ''Java'' overrides (likewise with ORM settings):
−
*** added method <code>initializeFrom(OrmSpecifiedMappedByRelationshipStrategy)</code>
+
*** <code>JavaSpecifiedAssociationOverride</code>
−
** <code>OrmSpecifiedPrimaryKeyJoinColumn</code>
+
**** added method <code>initializeFrom(JavaVirtualAssociationOverride)</code>
−
*** added method <code>initializeFrom(OrmSpecifiedPrimaryKeyJoinColumn)</code>
+
*** <code>JavaSpecifiedAttributeOverride</code>
−
*** added method <code>initializeFrom(OrmVirtualPrimaryKeyJoinColumn)</code>
+
**** added method <code>initializeFrom(JavaVirtualAttributeOverride)</code>
−
*** removed method <code>initializeFrom(PrimaryKeyJoinColumn)</code>
+
*** <code>OrmSpecifiedAssociationOverride</code>
−
** <code>OrmSpecifiedPrimaryKeyJoinColumnRelationshipStrategy</code>
+
**** added method <code>initializeFrom(OrmVirtualAssociationOverride)</code>
−
*** added method <code>initializeFrom(OrmSpecifiedPrimaryKeyJoinColumnRelationshipStrategy)</code>
+
*** <code>OrmSpecifiedAttributeOverride</code>
−
** <code>OrmSpecifiedSecondaryTable</code>
+
**** added method <code>initializeFrom(OrmVirtualAttributeOverride)</code>
−
*** added method <code>initializeFrom(OrmVirtualSecondaryTable)</code>
+
*** <code>SpecifiedOverrideRelationship</code>
−
*** removed method <code>initializeFrom(SecondaryTable)</code>
+
**** renamed method <code>initializeFromVirtual(OverrideRelationship)</code> to <code>initializeFrom(VirtualOverrideRelationship)</code>
−
** <code>OrmCollectionTable2_0</code>
+
**** removed method <code>initializeFromVirtualJoinColumnRelationship(JoinColumnRelationship)</code>
−
*** added method <code>initializeFrom(OrmCollectionTable2_0)</code>
+
**** removed method <code>initializeFromVirtualJoinTableRelationship(JoinTableRelationship)</code>
−
*** removed method <code>initializeFrom(CollectionTable2_0)</code>
+
*** <code>SpecifiedJoinColumnRelationshipStrategy</code>
 +
**** renamed method <code>initializeFromVirtual(JoinColumnRelationshipStrategy)</code> to <code>initializeFrom(VirtualJoinColumnRelationshipStrategy)</code>
 +
*** <code>SpecifiedJoinTableRelationshipStrategy</code>
 +
**** renamed method <code>initializeFromVirtual(JoinTableRelationshipStrategy)</code> to <code>initializeFrom(VirtualJoinTableRelationshipStrategy)</code>
 +
*** <code>SpecifiedJoinTable</code>
 +
**** renamed method <code>initializeFromVirtual(JoinTable)</code> to <code>initializeFrom(VirtualJoinTable)</code>
 +
*** <code>SpecifiedColumn</code>
 +
**** added method <code>initializeFrom(VirtualColumn)</code>
 +
*** <code>SpecifiedJoinColumn</code>
 +
**** renamed method <code>initializeFromVirtual(JoinColumn)</code> to <code>initializeFrom(VirtualJoinColumn)</code>
 +
*** <code>OrmSpecifiedSecondaryTable</code>
 +
**** added method <code>initializeFrom(OrmVirtualSecondaryTable)</code>
 +
*** <code>OrmSpecifiedPrimaryKeyJoinColumn</code>
 +
**** added method <code>initializeFrom(OrmVirtualPrimaryKeyJoinColumn)</code>
  
 
=== JAXB Core (Provisional API) ===
 
=== JAXB Core (Provisional API) ===

Revision as of 12:02, 18 June 2013

Overview

This page collects notes and pointers to changes coming up in the WTP 3.6 (Luna) release.

This page acts as a central "jumping off" point for those adopters of WTP that are moving up from a previous version of WTP. Most of this information may be already contained in various mailing lists and Bugzilla reports, but it is believed best to have a central place to get people started. Adopters: if you run into trouble or notice things that are not covered here, please update this page and/or let us know (such as by opening a bug, or sending a note to wtp-dev). Web Tools is a Platform and we strive to provide compatible API evolution with clear migration paths, instructions, etc.

One thing we have learned in the past is that some adopters do not move with us to every new release. Some early adopters went from 0.7 directly to 1.5, for example. Unfortunately, it is difficult to present the information in that way, covering multiple changes across multiple version ranges, so those types of migrations have to read about migrating to each version.

Note: as these notes develop and grow in number, they may occasionally be re-organized into categories, etc.

Dali

Common UI (Provisional API)

  • reworked item provider interfaces:
    • new interface ItemContentProvider
    • ItemTreeContentProvider
      • now extends ItemContentProvider
      • Manager now extends ItemContentProvider.Manager
        • method updateChildren(Object) changed to childrenChanged(Object, Iterable, Iterable)
      • Factory now extends ItemStructuredContentProvider.Factory
        • method buildProvider(Object, Manager) changed to buildProvider(Object, Object, Manager)
    • ItemStructuredContentProvider
      • now extends ItemContentProvider
      • Manager now extends ItemContentProvider.Manager
        • method updateElements(Object) changed to elementsChanged(Object, Iterable, Iterable)
    • ItemLabelProvider
      • Manager
        • method updateLabel(Object) changed to labelChanged(Object)
        • new method getViewer()
    • ItemExtendedLabelProvider
      • Manager
        • method updateDescription(Object) changed to descriptionChanged(Object)

JPA Core (Provisional API)

  • XmlPersistenceUnit
    • added method sortClasses()
  • Renamed JpaContextModelRoot to JpaContextRoot and related changes:
    • renamed JpaContextModelRoot2_0 to JpaContextRoot2_0
    • JpaFactory
      • renamed buildContextModelRoot(JpaProject) to buildContextRoot(JpaProject)
    • JpaProject
      • renamed getContextModelRoot() to getContextRoot()
      • renamed CONTEXT_MODEL_ROOT_TRANSFORMER to CONTEXT_ROOT_TRANSFORMER
      • renamed ContextModelRootTransformer to ContextRootTransformer
  • Reworked the API for converting mapping relationship settings so it is more clear what types of objects are converted to and from. Specifically:
    • Only ORM specified mapping relationship settings are copied over, when an an ORM attribute mapping is converted to another mapping (In Java, the annotations are simply left in place and rediscovered when the new mapping annotation is added to the source file.):
      • SpecifiedAssociationOverride
        • removed method initializeFrom(AssociationOverride)
        • removed method initializeFromVirtual(AssociationOverride)
      • SpecifiedAttributeOverride
        • removed method initializeFrom(AttributeOverride)
        • removed method initializeFromVirtual(AttributeOverride)
      • OrmSpecifiedAttributeOverride
        • added method initializeFrom(OrmSpecifiedAttributeOverride)
      • Relationship
        • removed method initializeOn(SpecifiedRelationship)
      • OrmMappingRelationship
        • added method initializeFrom(OrmMappingRelationship)
        • added method initializeOn(OrmMappingRelationship)
        • added method initializeFromJoinColumnRelationship(OrmJoinColumnRelationship)
        • added method initializeFromJoinTableRelationship(OrmJoinTableRelationship)
        • added method initializeFromMappedByRelationship(OrmMappedByRelationship)
        • added method initializeFromPrimaryKeyJoinColumnRelationship(OrmPrimaryKeyJoinColumnRelationship)
      • OverrideRelationship
        • removed method initializeOnSpecified(SpecifiedOverrideRelationship)
      • OrmMappedByRelationship
        • added method getMappedByStrategy()
      • SpecifiedJoinColumnRelationshipStrategy
        • removed method initializeFrom(JoinColumnRelationshipStrategy)
      • OrmSpecifiedJoinColumnRelationshipStrategy
        • added method initializeFrom(OrmSpecifiedJoinColumnRelationshipStrategy)
      • SpecifiedJoinTableRelationshipStrategy
        • removed method initializeFrom(JoinTableRelationshipStrategy)
      • OrmSpecifiedJoinTableRelationshipStrategy
        • added method initializeFrom(OrmSpecifiedJoinTableRelationshipStrategy)
      • SpecifiedMappedByRelationshipStrategy
        • removed method initializeFrom(SpecifiedMappedByRelationshipStrategy)
      • OrmSpecifiedMappedByRelationshipStrategy
        • added method initializeFrom(OrmSpecifiedMappedByRelationshipStrategy)
      • OrmSpecifiedPrimaryKeyJoinColumnRelationshipStrategy
        • added method initializeFrom(OrmSpecifiedPrimaryKeyJoinColumnRelationshipStrategy)
      • SpecifiedJoinTable
        • removed method initializeFrom(JoinTable)
      • OrmSpecifiedJoinTable
        • added method initializeFrom(OrmSpecifiedJoinTable)
      • OrmSpecifiedColumn
        • added method initializeFrom(OrmSpecifiedColumn)
      • SpecifiedJoinColumn
        • removed method initializeFrom(JoinColumn)
      • OrmSpecifiedJoinColumn
        • added method initializeFrom(OrmSpecifiedJoinColumn)
      • OrmSpecifiedPrimaryKeyJoinColumn
        • removed method initializeFrom(PrimaryKeyJoinColumn)
        • added method initializeFrom(OrmSpecifiedPrimaryKeyJoinColumn)
      • OrmSpecifiedSecondaryTable
        • removed method initializeFrom(SecondaryTable)
      • OrmCollectionTable2_0
        • removed method initializeFrom(CollectionTable2_0)
        • added method initializeFrom(OrmCollectionTable2_0)
    • Virtual Java override relationship settings are copied only to a specified Java overrides (likewise with ORM settings):
      • JavaSpecifiedAssociationOverride
        • added method initializeFrom(JavaVirtualAssociationOverride)
      • JavaSpecifiedAttributeOverride
        • added method initializeFrom(JavaVirtualAttributeOverride)
      • OrmSpecifiedAssociationOverride
        • added method initializeFrom(OrmVirtualAssociationOverride)
      • OrmSpecifiedAttributeOverride
        • added method initializeFrom(OrmVirtualAttributeOverride)
      • SpecifiedOverrideRelationship
        • renamed method initializeFromVirtual(OverrideRelationship) to initializeFrom(VirtualOverrideRelationship)
        • removed method initializeFromVirtualJoinColumnRelationship(JoinColumnRelationship)
        • removed method initializeFromVirtualJoinTableRelationship(JoinTableRelationship)
      • SpecifiedJoinColumnRelationshipStrategy
        • renamed method initializeFromVirtual(JoinColumnRelationshipStrategy) to initializeFrom(VirtualJoinColumnRelationshipStrategy)
      • SpecifiedJoinTableRelationshipStrategy
        • renamed method initializeFromVirtual(JoinTableRelationshipStrategy) to initializeFrom(VirtualJoinTableRelationshipStrategy)
      • SpecifiedJoinTable
        • renamed method initializeFromVirtual(JoinTable) to initializeFrom(VirtualJoinTable)
      • SpecifiedColumn
        • added method initializeFrom(VirtualColumn)
      • SpecifiedJoinColumn
        • renamed method initializeFromVirtual(JoinColumn) to initializeFrom(VirtualJoinColumn)
      • OrmSpecifiedSecondaryTable
        • added method initializeFrom(OrmVirtualSecondaryTable)
      • OrmSpecifiedPrimaryKeyJoinColumn
        • added method initializeFrom(OrmVirtualPrimaryKeyJoinColumn)

JAXB Core (Provisional API)

  • JaxbProjectManager
    • added method getJaxbWorkspace()

JAXB UI (Provisional API)

  • New interfaces
    • JaxbProjectsModel
    • JaxbProjectModel

Reference

This document covers ONLY changes between WTP 3.6 and WTP 3.5. See also:

Retrieved from "https://wiki.eclipse.org/index.php?title=New_Help_for_Old_Friends_IX&oldid=340264"

Copyright © Eclipse Foundation, Inc. All Rights Reserved.