Subversion Repositories WebE

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
33 PointedEar 1
//$Id: EntityManagerFactory.java 11282 2007-03-14 22:05:59Z epbernard $
2
package javax.persistence;
3
 
4
import java.util.Map;
5
 
6
/**
7
 * The EntityManagerFactory interface is used by the application to obtain an
8
 * application-managed entity manager. When the application has finished using
9
 * the entity manager factory, and/or at application shutdown, the application
10
 * should close the entity manager factory. Once an EntityManagerFactory has been
11
 * closed, all its entity managers are considered to be in the closed state.
12
 *
13
 * @author Emmanuel Bernard
14
 */
15
public interface EntityManagerFactory {
16
 
17
        /**
18
         * Create a new EntityManager.
19
         * This method returns a new EntityManager instance each time
20
         * it is invoked.
21
         * The isOpen method will return true on the returned instance.
22
         */
23
        EntityManager createEntityManager();
24
 
25
        /**
26
         * Create a new EntityManager with the specified Map of
27
         * properties.
28
         * This method returns a new EntityManager instance each time
29
         * it is invoked.
30
         * The isOpen method will return true on the returned instance.
31
         */
32
        EntityManager createEntityManager(Map map);
33
 
34
        /**
35
         * Close the factory, releasing any resources that it holds.
36
         * After a factory instance is closed, all methods invoked on
37
         * it will throw an IllegalStateException, except for isOpen,
38
         * which will return false. Once an EntityManagerFactory has
39
         * been closed, all its entity managers are considered to be
40
         * in the closed state.
41
         */
42
        void close();
43
 
44
        /**
45
         * Indicates whether or not this factory is open. Returns
46
         * true until a call to close has been made.
47
         */
48
        public boolean isOpen();
49
}