* Assumes a base JPA project context structure * corresponding to the JPA spec:
orm.xml)* 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. * * @see org.eclipse.jpt.jpa.core.internal.jpa1.GenericJpaFactory * * @version 3.1 * @since 2.0 */ public interface JpaFactory { // ********** Core Model ********** /** * Construct a JpaProject for the specified config, to be * added to the specified JPA project. Return null if unable to create * the JPA file (e.g. the content type is unrecognized). */ JpaProject buildJpaProject(JpaProject.Config config); JpaDataSource buildJpaDataSource(JpaProject jpaProject, String connectionProfileName); /** * Construct a JPA file for the specified JPA project, file, content type, * and resource model. */ JpaFile buildJpaFile(JpaProject jpaProject, IFile file, IContentType contentType, JptResourceModel resourceModel); // ********** Context Nodes ********** /** * Build a (/an updated) root context node to be associated with the given * JPA project. * The root context node will be built once, but updated many times. * @see org.eclipse.jpt.jpa.core.internal.AbstractJpaProject#update(org.eclipse.core.runtime.IProgressMonitor) */ JpaRootContextNode buildRootContextNode(JpaProject jpaProject); // ********** XML Context Model ********** PersistenceXml buildPersistenceXml(JpaRootContextNode parent, JpaXmlResource resource); MappingFile buildMappingFile(MappingFileRef parent, Object resourceMappingFile); // ********** Java Context Model ********** JavaPersistentType buildJavaPersistentType(PersistentType.Owner owner, JavaResourceType jrt); JavaEntity buildJavaEntity(JavaPersistentType parent, EntityAnnotation entityAnnotation); JavaMappedSuperclass buildJavaMappedSuperclass(JavaPersistentType parent, MappedSuperclassAnnotation mappedSuperclassAnnotation); JavaEmbeddable buildJavaEmbeddable(JavaPersistentType parent, EmbeddableAnnotation embeddableAnnotation); JavaTypeMapping buildJavaNullTypeMapping(JavaPersistentType parent); JavaPersistentAttribute buildJavaPersistentAttribute(PersistentType parent, Accessor accessor); JavaPersistentAttribute buildJavaPersistentField(PersistentType parent, JavaResourceField resourceField); JavaPersistentAttribute buildJavaPersistentProperty(PersistentType parent, JavaResourceMethod resourceGetter, JavaResourceMethod resourceSetter); JavaBasicMapping buildJavaBasicMapping(JavaPersistentAttribute parent); JavaEmbeddedIdMapping buildJavaEmbeddedIdMapping(JavaPersistentAttribute parent); JavaEmbeddedMapping buildJavaEmbeddedMapping(JavaPersistentAttribute parent); JavaIdMapping buildJavaIdMapping(JavaPersistentAttribute parent); JavaManyToManyMapping buildJavaManyToManyMapping(JavaPersistentAttribute parent); JavaManyToOneMapping buildJavaManyToOneMapping(JavaPersistentAttribute parent); JavaOneToManyMapping buildJavaOneToManyMapping(JavaPersistentAttribute parent); JavaOneToOneMapping buildJavaOneToOneMapping(JavaPersistentAttribute parent); JavaTransientMapping buildJavaTransientMapping(JavaPersistentAttribute parent); JavaVersionMapping buildJavaVersionMapping(JavaPersistentAttribute parent); JavaAttributeMapping buildJavaNullAttributeMapping(JavaPersistentAttribute parent); JavaGeneratorContainer buildJavaGeneratorContainer(JavaGeneratorContainer.ParentAdapter parentAdapter); JavaTable buildJavaTable(JavaEntity parent, Table.Owner owner); JavaJoinTable buildJavaJoinTable(JavaJoinTableRelationshipStrategy parent, Table.Owner owner); JavaVirtualJoinTable buildJavaVirtualJoinTable(JavaVirtualJoinTableRelationshipStrategy parent, ReadOnlyTable.Owner owner, ReadOnlyJoinTable overriddenTable); JavaColumn buildJavaColumn(JavaJpaContextNode parent, JavaColumn.Owner owner); JavaVirtualColumn buildJavaVirtualColumn(JavaJpaContextNode parent, JavaVirtualColumn.Owner owner); JavaDiscriminatorColumn buildJavaDiscriminatorColumn(JavaEntity parent, JavaDiscriminatorColumn.Owner owner); JavaJoinColumn buildJavaJoinColumn(JavaJpaContextNode parent, JavaReadOnlyJoinColumn.Owner owner, CompleteJoinColumnAnnotation joinColumnAnnotation); JavaVirtualJoinColumn buildJavaVirtualJoinColumn(JavaJpaContextNode parent, JavaReadOnlyJoinColumn.Owner owner, ReadOnlyJoinColumn overriddenColumn); JavaSecondaryTable buildJavaSecondaryTable(JavaEntity parent, Table.Owner owner, SecondaryTableAnnotation tableAnnotation); JavaSequenceGenerator buildJavaSequenceGenerator(JavaGeneratorContainer parent, SequenceGeneratorAnnotation sequenceGeneratorAnnotation); JavaTableGenerator buildJavaTableGenerator(JavaGeneratorContainer parent, TableGeneratorAnnotation tableGeneratorAnnotation); JavaGeneratedValue buildJavaGeneratedValue(JavaIdMapping parent, GeneratedValueAnnotation generatedValueAnnotation); JavaPrimaryKeyJoinColumn buildJavaPrimaryKeyJoinColumn(JavaJpaContextNode parent, JavaReadOnlyBaseJoinColumn.Owner owner, PrimaryKeyJoinColumnAnnotation pkJoinColumnAnnotation); JavaAttributeOverrideContainer buildJavaAttributeOverrideContainer(JavaJpaContextNode parent, JavaAttributeOverrideContainer.Owner owner); JavaAttributeOverride buildJavaAttributeOverride(JavaAttributeOverrideContainer parent, AttributeOverrideAnnotation annotation); JavaVirtualAttributeOverride buildJavaVirtualAttributeOverride(JavaAttributeOverrideContainer parent, String name); JavaAssociationOverrideContainer buildJavaAssociationOverrideContainer(JavaJpaContextNode parent, JavaAssociationOverrideContainer.Owner owner); JavaAssociationOverride buildJavaAssociationOverride(JavaAssociationOverrideContainer parent, AssociationOverrideAnnotation annotation); JavaVirtualAssociationOverride buildJavaVirtualAssociationOverride(JavaAssociationOverrideContainer parent, String name); JavaOverrideRelationship buildJavaOverrideRelationship(JavaAssociationOverride parent); JavaVirtualOverrideRelationship buildJavaVirtualOverrideRelationship(JavaVirtualAssociationOverride parent); JavaQueryContainer buildJavaQueryContainer(JavaJpaContextNode parent, JavaQueryContainer.Owner owner); JavaNamedQuery buildJavaNamedQuery(JavaQueryContainer parent, NamedQueryAnnotation namedQueryAnnotation); JavaNamedNativeQuery buildJavaNamedNativeQuery(JavaQueryContainer parent, NamedNativeQueryAnnotation namedNativeQueryAnnotation); JavaQueryHint buildJavaQueryHint(JavaQuery parent, QueryHintAnnotation queryHintAnnotation); JavaUniqueConstraint buildJavaUniqueConstraint(JavaJpaContextNode parent, UniqueConstraint.Owner owner, UniqueConstraintAnnotation constraintAnnotation); JavaVirtualUniqueConstraint buildJavaVirtualUniqueConstraint(JavaJpaContextNode parent, ReadOnlyUniqueConstraint overriddenUniqueConstraint); JavaBaseEnumeratedConverter buildJavaBaseEnumeratedConverter(JavaAttributeMapping parent, BaseEnumeratedAnnotation annotation, JavaConverter.Owner owner); JavaBaseTemporalConverter buildJavaBaseTemporalConverter(JavaAttributeMapping parent, BaseTemporalAnnotation annotation, JavaConverter.Owner owner); JavaLobConverter buildJavaLobConverter(JavaAttributeMapping parent, LobAnnotation annotation, JavaConverter.Owner owner); JavaOrderable buildJavaOrderable(JavaAttributeMapping parent); }