geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From djen...@apache.org
Subject svn commit: r721010 - /geronimo/specs/trunk/geronimo-jpa_2.0_spec/src/main/java/javax/persistence/EntityManagerFactory.java
Date Wed, 26 Nov 2008 22:37:21 GMT
Author: djencks
Date: Wed Nov 26 14:37:21 2008
New Revision: 721010

URL: http://svn.apache.org/viewvc?rev=721010&view=rev
Log:
GERONIMO-4410 apply second set of jpa 2 api updates.  EntityManagerFactory updates missed
in previous commit due to merge problems.  There is a missing Cache class so the last method
getCache() is commented out.

Modified:
    geronimo/specs/trunk/geronimo-jpa_2.0_spec/src/main/java/javax/persistence/EntityManagerFactory.java

Modified: geronimo/specs/trunk/geronimo-jpa_2.0_spec/src/main/java/javax/persistence/EntityManagerFactory.java
URL: http://svn.apache.org/viewvc/geronimo/specs/trunk/geronimo-jpa_2.0_spec/src/main/java/javax/persistence/EntityManagerFactory.java?rev=721010&r1=721009&r2=721010&view=diff
==============================================================================
--- geronimo/specs/trunk/geronimo-jpa_2.0_spec/src/main/java/javax/persistence/EntityManagerFactory.java
(original)
+++ geronimo/specs/trunk/geronimo-jpa_2.0_spec/src/main/java/javax/persistence/EntityManagerFactory.java
Wed Nov 26 14:37:21 2008
@@ -25,17 +25,82 @@
 package javax.persistence;
 
 import java.util.Map;
+import java.util.Set;
 
 /**
+ * Interface used to interact with the entity manager factory
+ * for the persistence unit. 
  * @version $Rev$ $Date$
  */
 public interface EntityManagerFactory {
 
-	EntityManager createEntityManager();
-
-	EntityManager createEntityManager(Map map);
-
-	void close();
-
-	public boolean isOpen();
+    /**
+    * Create a new EntityManager.
+    * This method returns a new EntityManager instance each time
+    * it is invoked.
+    * The isOpen method will return true on the returned instance.
+    * @throws IllegalStateException if the entity manager factory
+    * has been closed.
+    */
+    public EntityManager createEntityManager();
+    /**
+    * Create a new EntityManager with the specified Map of
+    * properties.
+    * This method returns a new EntityManager instance each time
+    * it is invoked.
+    * The isOpen method will return true on the returned instance.
+    * @throws IllegalStateException if the entity manager factory
+    * has been closed.
+    */
+    public EntityManager createEntityManager(Map map);
+    /**
+    * Return an instance of QueryBuilder for the creation of
+    * Criteria API QueryDefinition objects.
+    * @return QueryBuilder instance
+    * @throws IllegalStateException if the entity manager factory
+    * has been closed.
+    */
+    public QueryBuilder getQueryBuilder();
+    /**
+    * Close the factory, releasing any resources that it holds.
+    * After a factory instance is closed, all methods invoked on
+    * it will throw an IllegalStateException, except for isOpen,
+    * which will return false. Once an EntityManagerFactory has
+    * been closed, all its entity managers are considered to be
+    * in the closed state.
+    * @throws IllegalStateException if the entity manager factory
+    * has been closed.
+    */
+    public void close();
+    /**
+    * Indicates whether the factory is open. Returns true
+    * until the factory has been closed.
+    */
+    public boolean isOpen();
+    /**
+    * Get the properties and associated values that are in effect
+    * for the entity manager factory. Changing the contents of the
+    * map does not change the configuration in effect.
+    * @return properties
+    */
+    public Map getProperties();
+    /**
+    * Get the names of the properties that are supported for use
+    * with the entity manager factory. These correspond to
+    * properties that may be passed to the methods of the
+    * EntityManagerFactory interface that take a properties
+    * argument. These include all standard properties as well as
+    * vendor-specific properties supported by the provider. These
+    * properties may or may not currently be in effect.
+    * @return properties and hints
+    */
+    public Set<String> getSupportedProperties();
+    /**
+    * Access the cache that is associated with the entity manager
+    * factory (the "second level cache").
+    * @return instance of the Cache interface
+    * @throws IllegalStateException if the entity manager factory
+    * has been closed.
+    */
+//    public Cache getCache();
 }



Mime
View raw message