org.eclipse.jpt.jpa.core.jpa2
Interface MetamodelSynchronizer

All Known Subinterfaces:

JpaRootContextNode2_0, Persistence2_0, PersistenceUnit2_0, PersistenceXml2_0

All Known Implementing Classes:

org.eclipse.jpt.jpa.core.internal.context.persistence.AbstractPersistenceUnit, EclipseLinkPersistenceUnit, MetamodelSynchronizer.Null

public interface MetamodelSynchronizer

JPA 2.0 Canonical Metamodel synchronizer.

Notes:

• When a JPA project is first created (e.g. when the user adds the JPA Facet to a Faceted project or when a workspace containing a JPA project is opened), if it is configured to generate the Canonical Metamodel (i.e. its metamodel source folder is non- null), it will first discover what metamodel classes are already present in the metamodel source folder. Any class appropriately annotated with javax.persistence.metamodel.StaticMetamodel and javax.annotation.Generated will be added to the Canonical Metamodel (see MetamodelSynchronizer.MetamodelTools.isGeneratedMetamodelTopLevelType(JavaResourceAbstractType, IPackageFragmentRoot)). Once the JPA project's context model is constructed, a new Canonical Metamodel is generated and merged with the classes already present in the metamodel source folder.
• When a JPA project's metamodel source folder setting is cleared, the Canonical Metamodel is cleared from the context model, but the generated source files are left in place.
• When a JPA project's metamodel source folder is set to a non-null value, like when a JPA project is first created, the resulting Canonical Metamodel will be merged with whatever is already present in the folder.

Provisional API: This interface is part of an interim API that is still under development and expected to change significantly before reaching stability. It is available at this early stage to solicit feedback from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken (repeatedly) as the API evolves.

Since:

2.3

Nested Class Summary

static class	MetamodelSynchronizer.MetamodelTools
static class	MetamodelSynchronizer.Null Singleton implementation of the metamodel synchronizer interface that does nothing.

Field Summary

static String

METAMODEL_GENERATED_ANNOTATION_VALUE The value used to tag a generated type: @javax.annotation.Generated(value="Dali", date="2009-11-23T13:56:06.171-0500")

Method Summary

void	disposeMetamodel()
void	initializeMetamodel()
IStatus	synchronizeMetamodel(IProgressMonitor progressMonitor)

Field Detail

METAMODEL_GENERATED_ANNOTATION_VALUE

static final String METAMODEL_GENERATED_ANNOTATION_VALUE

The value used to tag a generated type:

 @javax.annotation.Generated(value="Dali", date="2009-11-23T13:56:06.171-0500")
 

See Also:

Constant Field Values

Method Detail

initializeMetamodel

void initializeMetamodel()

synchronizeMetamodel

IStatus synchronizeMetamodel(IProgressMonitor progressMonitor)

disposeMetamodel

void disposeMetamodel()