JPA-38 - Schema generation requirements

src/main/java/javax/persistence/Persistence.java

@@ -69,6 +69,32 @@ private static List<PersistenceProvider> getProviders() {
 				.getPersistenceProviders();
 	}
 
+	/**
+	 * Create database schemas and/or tables and/or create DDL scripts as determined by the supplied properties
+	 *
+	 * Called when schema generation is to occur as a separate phase from creation of the entity manager factory.
+	 *
+	 * @param persistenceUnitName the name of the persistence unit
+	 * @param properties properties for schema generation; these may also contain provider-specific properties. The
+	 * values of these properties override any values that may have been configured elsewhere.
+	 *
+	 * @throws PersistenceException if insufficient or inconsistent configuration information is provided or if schema
+	 * generation otherwise fails.
+	 */
+	public static void generateSchema(String persistenceUnitName, Map properties) {
+		List<PersistenceProvider> providers = getProviders();
+		for ( PersistenceProvider provider : providers ) {
+			final boolean generated = provider.generateSchema( persistenceUnitName, properties );
+			if ( generated ) {
+				return;
+			}
+		}
+
+		throw new PersistenceException(
+				"No persistence provider found for schema generation for persistence-unit named " + persistenceUnitName
+		);
+	}
+
 	/**
 	 * @return Returns a <code>PersistenceUtil</code> instance.
 	 */

src/main/java/javax/persistence/spi/PersistenceProvider.java

@@ -56,6 +56,40 @@ public interface PersistenceProvider {
 	 */
 	public EntityManagerFactory createContainerEntityManagerFactory(PersistenceUnitInfo info, Map map);
 
+	/**
+	 * Create database schemas and/or tables and/or create DDL
+	 * scripts as determined by the supplied properties.
+	 *
+	 * Called by the container when schema generation is to
+	 * occur as a separate phase from creation of the entity
+	 * manager factory.
+	 *
+	 * @param info metadata for use by the persistence provider
+	 * @param map properties for schema generation; these may also include provider-specific properties
+	 *
+	 * @throws javax.persistence.PersistenceException if insufficient or inconsistent configuration information is
+	 * provided or if schema generation otherwise fails.
+	 */
+	public void generateSchema(PersistenceUnitInfo info, Map map);
+
+	/**
+	 * Create database schemas and/or tables and/or create DDL
+	 * scripts as determined by the supplied properties.
+	 * Called by the Persistence class when schema generation is to
+	 * occur as a separate phase from creation of the entity
+	 * manager factory.
+	 *
+	 * @param persistenceUnitName the name of the persistence unit
+	 * @param map properties for schema generation; these may also contain provider-specific properties. The value of
+	 * these properties override any values that may have been configured elsewhere.
+	 *
+	 * @return true if schema was generated, otherwise false
+	 *
+	 * @throws javax.persistence.PersistenceException if insufficient or inconsistent configuration information is
+	 * provided or if schema generation otherwise fails.
+	 */
+	public boolean generateSchema(String persistenceUnitName, Map map);
+
 	/**
 	 * Return the utility interface implemented by the persistence
 	 * provider.