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

New Help for Old Friends VIII

Revision as of 11:50, 20 June 2012 by Brian.vosburgh.oracle.com (Talk | contribs) (JPA Database (Provisional API))

Overview

This page collects notes and pointers to changes coming up in the WTP 3.5 (Kepler) 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

General

  • All the BundleActivator implementations (i.e. "plug-in" classes; e.g. JptJpaCorePlugin) were moved from public packages to private packages and all public members moved to the appropriate public interfaces etc.

Common Core (Provisional API)

  • JptCommonCorePlugin - moved to private package and moved its members to the appropriate public interfaces etc.

Old New
JAVA_SOURCE_CONTENT_TYPE JavaResourceCompilationUnit.CONTENT_TYPE
JAVA_SOURCE_RESOURCE_TYPE JavaResourceCompilationUnit.RESOURCE_TYPE
JAVA_SOURCE_PACKAGE_INFO_CONTENT_TYPE JavaResourceCompilationUnit.PACKAGE_INFO_CONTENT_TYPE
JAVA_SOURCE_PACKAGE_INFO_RESOURCE_TYPE JavaResourceCompilationUnit.PACKAGE_INFO_RESOURCE_TYPE
JAR_CONTENT_TYPE JavaResourcePackageFragmentRoot.JAR_CONTENT_TYPE
JAR_SOURCE_RESOURCE_TYPE JavaResourcePackageFragmentRoot.JAR_RESOURCE_TYPE
getLibraryValidators(...) LibraryValidatorManager.getLibraryValidators(...)

JPA Database (Provisional API)

  • JptJpaDbPlugin - moved to private package and moved its members to the appropriate public interfaces etc.

Old New
getConnectionProfileFactory() IWorkspace.getAdapter(ConnectionProfileFactory.class)
buildDriverClasspathContainerFor(...)

  • promoted the method refresh() from Schema to DatabaseObject
  • added ConnectionProfileFactory.getWorkspace()

JPA Core (Provisional API)

  • JptJpaCorePlugin - moved to private package and moved its members to the appropriate public interfaces etc.

Old New
DEFAULT_PERSISTENCE_XML_RUNTIME_PATH XmlPersistence.DEFAULT_RUNTIME_PATH
PERSISTENCE_XML_CONTENT_TYPE XmlPersistence.CONTENT_TYPE
PERSISTENCE_XML_1_0_CONTENT_TYPE XmlPersistence.CONTENT_TYPE
PERSISTENCE_XML_2_0_CONTENT_TYPE XmlPersistence.CONTENT_TYPE
MAPPING_FILE_CONTENT_TYPE ResourceMappingFile.Root.CONTENT_TYPE
DEFAULT_ORM_XML_RUNTIME_PATH XmlEntityMappings.DEFAULT_RUNTIME_PATH
ORM_XML_CONTENT_TYPE XmlEntityMappings.CONTENT_TYPE
ORM_XML_RESOURCE_TYPE XmlEntityMappings.RESOURCE_TYPE
ORM_XML_1_0_RESOURCE_TYPE XmlEntityMappings.RESOURCE_TYPE_1_0
ORM_XML_2_0_RESOURCE_TYPE XmlEntityMappings.RESOURCE_TYPE_2_0
VALIDATION_MARKER_ID JpaValidator.MARKER_ID
VALIDATOR_ID removed
WEB_FACET ProjectFacetsManager.getProjectFacet(IModuleConstants.JST_WEB_MODULE)
USER_OVERRIDE_DEFAULT_CATALOG JpaProject.USER_OVERRIDE_DEFAULT_CATALOG_PERSISTENT_PROPERTY_KEY
USER_OVERRIDE_DEFAULT_SCHEMA JpaProject.USER_OVERRIDE_DEFAULT_SCHEMA_PERSISTENT_PROPERTY_KEY
DATA_SOURCE_CONNECTION_PROFILE_NAME JpaDataSource.CONNECTION_PROFILE_NAME_PERSISTENT_PROPERTY_KEY
getConnectionProfileName(...) removed
setConnectionProfileName(...) removed
getUserOverrideDefaultCatalog(...) removed
setUserOverrideDefaultCatalog(...) removed
getUserOverrideDefaultSchema(...) removed
setUserOverrideDefaultSchema(...) removed
clearProjectPersistentProperties(...) removed
getJarRuntimeRootPath(...) ProjectTools.getJarRuntimeRootPath(...)
nodeIsXml2_0Compatible(...)
projectHasWebFacet(...) ProjectTools.hasWebFacet(...)

  • JpaStructureNode now extends JpaContextNode
  • renamed AbstractXmlResourceProvider to AbstractJpaXmlResourceProvider and moved to internal package
  • added method to JpaXmlResourceProvider
  • moved JpaXmlResourceProvider to appropriate package and added method createFileAndResource(...)
  • cleaned up support for non-XML mapping files:
    • changed the resource passed to the method JpaFactory.buildMappingFile(...) from JpaXmlResource to Object
    • moved MappingFileRoot to be a member type: MappingFile.Root
    • added change support for MappingFile.ROOT_PROPERTY
    • added methods to MappingFile:
      • getResourceMappingFile()
      • validate(...)
      • getValidationTextRange()
    • MappingFilePersistenceUnitMetadata now extends JpaContextNode, not XmlContextNode and declares the method getValidationTextRange()
    • MappingFilePersistenceUnitDefaults now extends JpaContextNode, not XmlContextNode
    • added support for a root to XmlFile
    • OrmXml now extends XmlFile
    • EntityMappings now extends both MappingFile.Root and XmlFile.Root
    • Persistence now extends XmlFile.Root
    • replaced PersistenceXml.getPersistence() with getRoot()
  • removed JpaXmlStructureNode and moved method getXmlCompletionProposals(...) to XmlContextNode
  • removed unneeded method MappingFileRef.isFor(...)
  • renamed MappingFileRef.isImplied() to MappingFileRef.isDefault()
  • renamed PersistenceXmlContextNodeFactory.buildImpliedMappingFileRef(...) to PersistenceXmlContextNodeFactory.buildVirtualMappingFileRef(...)
  • added method JpaNode.getJpaPlatform()
  • deleted class JpaFacet
    • moved ID to JpaProject.FACET_ID
    • moved FACET to JpaProject.FACET
    • moved VERSION_1_0 to JpaProject.FACET_VERSION_STRING and JpaProject.FACET_VERSION
    • moved VERSION_2_0 to JpaProject2_0.FACET_VERSION_STRING and JpaProject2_0.FACET_VERSION

JAXB Core (Provisional API)

  • JptJaxbCorePlugin - moved to private package and moved its members to the appropriate public interfaces etc.

Old New
JAXB_INDEX_CONTENT_TYPE JaxbIndexResource.CONTENT_TYPE
JAXB_INDEX_RESOURCE_TYPE JaxbIndexResource.RESOURCE_TYPE
JAXB_PROPERTIES_CONTENT_TYPE JaxbPropertiesResource.CONTENT_TYPE
JAXB_PROPERTIES_RESOURCE_TYPE JaxbPropertiesResource.RESOURCE_TYPE
VALIDATION_MARKER_ID JaxbValidator.MARKER_ID

EclipseLink JPA Core (Provisional API)

  • JptJpaEclipseLinkCorePlugin - moved to private package and moved its members to the appropriate public interfaces etc.

Old New
DEFAULT_ECLIPSELINK_ORM_XML_RUNTIME_PATH XmlEntityMappings.DEFAULT_RUNTIME_PATH
ECLIPSELINK_ORM_XML_CONTENT_TYPE XmlEntityMappings.CONTENT_TYPE
ECLIPSELINK_ORM_XML_1_0_RESOURCE_TYPE XmlEntityMappings.RESOURCE_TYPE_1_0
ECLIPSELINK_ORM_XML_1_1_RESOURCE_TYPE XmlEntityMappings.RESOURCE_TYPE_1_1
ECLIPSELINK_ORM_XML_1_2_RESOURCE_TYPE XmlEntityMappings.RESOURCE_TYPE_1_2
ECLIPSELINK_ORM_XML_2_0_RESOURCE_TYPE XmlEntityMappings.RESOURCE_TYPE_2_0
ECLIPSELINK_ORM_XML_2_1_RESOURCE_TYPE XmlEntityMappings.RESOURCE_TYPE_2_1
ECLIPSELINK_ORM_XML_2_2_RESOURCE_TYPE XmlEntityMappings.RESOURCE_TYPE_2_2
ECLIPSELINK_ORM_XML_2_3_RESOURCE_TYPE XmlEntityMappings.RESOURCE_TYPE_2_3
ECLIPSELINK_ORM_XML_2_4_RESOURCE_TYPE XmlEntityMappings.RESOURCE_TYPE_2_4
ECLIPSELINK_PLATFORM_VERSION_1_0 EclipseLinkJpaPlatformFactory.VERSION
ECLIPSELINK_PLATFORM_VERSION_1_1 EclipseLink1_1JpaPlatformFactory.VERSION
ECLIPSELINK_PLATFORM_VERSION_1_2 EclipseLink1_2JpaPlatformFactory.VERSION
ECLIPSELINK_PLATFORM_VERSION_2_0 EclipseLink2_0JpaPlatformFactory.VERSION
ECLIPSELINK_PLATFORM_VERSION_2_1 EclipseLink2_1JpaPlatformFactory.VERSION
ECLIPSELINK_PLATFORM_VERSION_2_2 EclipseLink2_2JpaPlatformFactory.VERSION
ECLIPSELINK_PLATFORM_VERSION_2_3 EclipseLink2_3JpaPlatformFactory.VERSION
ECLIPSELINK_PLATFORM_VERSION_2_4 EclipseLink2_4JpaPlatformFactory.VERSION
nodeIsEclipseLink2_3Compatible(...) removed
nodeIsEclipseLink2_4Compatible(...) removed
nodeIsEclipseLinkVersionCompatible(...) removed

JPA UI (Provisional API)

  • enhanced JpaPlatformUi:
    • added getTypeMappingUiDefinition(...)
    • added getAttributeMappingUiDefinition(...)
  • converted Iterators to Iterables:
    • JpaPlatformUi.getTypeMappingUiDefinitions(...)
    • JpaPlatformUi.getAttributeMappingUiDefinitions(...)
    • JpaPlatformUiProvider.getDetailProviders()
    • JpaPlatformUiProvider.getResourceUiDefinitions()
    • MappingResourceUiDefinition.getTypeMappingUiDefinitions()
    • MappingResourceUiDefinition.getAttributeMappingUiDefinitions()
  • enhanced MappingResourceUiDefinition:
    • added getTypeMappingUiDefinition(...)
    • added getAttributeMappingUiDefinition(...)
  • enhanced MappingUiDefinition:
    • added getGhostImage()

Reference

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

Back to the top