01: /*
02: * Copyright 2004-2006 the original author or authors.
03: *
04: * Licensed under the Apache License, Version 2.0 (the "License");
05: * you may not use this file except in compliance with the License.
06: * You may obtain a copy of the License at
07: *
08: * http://www.apache.org/licenses/LICENSE-2.0
09: *
10: * Unless required by applicable law or agreed to in writing, software
11: * distributed under the License is distributed on an "AS IS" BASIS,
12: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13: * See the License for the specific language governing permissions and
14: * limitations under the License.
15: */
16:
17: package org.compass.gps.device.jpa;
18:
19: import javax.persistence.EntityManager;
20: import javax.persistence.EntityManagerFactory;
21:
22: /**
23: * A native <code>EntityManagerFactory<code> extractor. Should be used with code/frameworks that
24: * wrap the actual <code>EntityManagerFactory</code>.
25: *
26: * @author kimchy
27: */
28: public interface NativeJpaExtractor {
29:
30: /**
31: * Returns the actual <code>EntityManagerFactory</code> based on the given <code>EntityManagerFactory</code>.
32: * Should return the same <code>EntityManagerFactory</code> if not wrapping has been done.
33: *
34: * @param entityManagerFactory The (possibly) wrapped <code>EntityManagerFactory</code>.
35: * @return The actual <code>EntityManagerFactory</code> implementation.
36: * @throws JpaGpsDeviceException
37: */
38: EntityManagerFactory extractNative(
39: EntityManagerFactory entityManagerFactory)
40: throws JpaGpsDeviceException;
41:
42: /**
43: * Extracts the native <code>EntityManager</code> based on the given <code>EntityManager</code>.
44: * Should return the same <code>EntityManager</code> if no wrapper has been done.
45: *
46: * @param entityManager The (possibly) wrapper <code>EntityManager</code>.
47: * @return The actual <code>EntityManager</code>.
48: * @throws JpaGpsDeviceException
49: */
50: EntityManager extractNative(EntityManager entityManager)
51: throws JpaGpsDeviceException;
52: }
|