Package org.apache.openjpa.persistence
Class OpenJPAPersistence
- java.lang.Object
-
- org.apache.openjpa.persistence.OpenJPAPersistence
-
public class OpenJPAPersistence extends java.lang.Object
Static helper methods for JPA users.- Since:
- 0.4.0
- Author:
- Abe White
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
EM_KEY
Deprecated.useJPAFacadeHelper
instead.static java.lang.String
EMF_KEY
Deprecated.useJPAFacadeHelper
instead.
-
Constructor Summary
Constructors Constructor Description OpenJPAPersistence()
-
Method Summary
All Methods Static Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static OpenJPAEntityManager
cast(jakarta.persistence.EntityManager em)
Return the OpenJPA facade to the given entity manager.static OpenJPAEntityManagerFactory
cast(jakarta.persistence.EntityManagerFactory emf)
Return the OpenJPA facade to the given entity manager factory.static OpenJPAQuery
cast(jakarta.persistence.Query q)
Return the OpenJPA facade to the given query.static void
close(java.lang.Object o)
Close the given resource.static OpenJPAEntityManagerFactory
createEntityManagerFactory(java.lang.String name, java.lang.String resource)
Returns a newOpenJPAEntityManagerFactory
specified byname
in an XML configuration file at the resource locationresource
.static OpenJPAEntityManagerFactory
createEntityManagerFactory(java.lang.String name, java.lang.String resource, java.util.Map map)
Returns a newOpenJPAEntityManagerFactory
specified byname
in an XML configuration file at the resource locationresource
, applying the properties specified inmap
as overrides.static OpenJPAEntityManagerFactory
createEntityManagerFactory(java.lang.String jndiLocation, javax.naming.Context context)
Returns theEntityManagerFactory
at the JNDI location specified byjndiLocation
in the contextcontext
.static java.lang.Object
fromOpenJPAObjectId(java.lang.Object oid)
Deprecated.useJPAFacadeHelper
instead.static java.lang.Class
fromOpenJPAObjectIdClass(java.lang.Class oidClass)
Deprecated.useJPAFacadeHelper
instead.static OpenJPAEntityManager
getEntityManager(java.lang.Object o)
Return the entity manager for the given object, if one can be determined from just the object alone.static OpenJPAEntityManagerFactory
getEntityManagerFactory()
Returns theOpenJPAEntityManagerFactory
specified by your OpenJPA defaults.static OpenJPAEntityManagerFactory
getEntityManagerFactory(java.util.Map map)
Returns theOpenJPAEntityManagerFactory
specified by your OpenJPA defaults, usingmap
as overrides.static ClassMetaData
getMetaData(jakarta.persistence.EntityManagerFactory factory, java.lang.Class cls)
Deprecated.useJPAFacadeHelper
instead.static ClassMetaData
getMetaData(jakarta.persistence.EntityManager em, java.lang.Class cls)
Deprecated.useJPAFacadeHelper
instead.static ClassMetaData
getMetaData(java.lang.Object o)
Deprecated.useJPAFacadeHelper
instead.static boolean
isManagedType(jakarta.persistence.EntityManager em, java.lang.Class cls)
Returns true if the specified class is an entity or embeddable type.static Broker
toBroker(jakarta.persistence.EntityManager em)
Deprecated.useJPAFacadeHelper
instead.static BrokerFactory
toBrokerFactory(jakarta.persistence.EntityManagerFactory factory)
Deprecated.useJPAFacadeHelper
instead.static OpenJPAEntityManager
toEntityManager(Broker broker)
Deprecated.useJPAFacadeHelper
instead.static OpenJPAEntityManagerFactory
toEntityManagerFactory(BrokerFactory factory)
Deprecated.useJPAFacadeHelper
instead.static java.lang.Object
toOpenJPAObjectId(ClassMetaData meta, java.lang.Object oid)
Deprecated.useJPAFacadeHelper
instead.static java.lang.Object[]
toOpenJPAObjectIds(ClassMetaData meta, java.lang.Object... oids)
Deprecated.useJPAFacadeHelper
instead.static java.util.Collection
toOpenJPAObjectIds(ClassMetaData meta, java.util.Collection oids)
Deprecated.useJPAFacadeHelper
instead.
-
-
-
Field Detail
-
EM_KEY
@Deprecated public static final java.lang.String EM_KEY
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.- See Also:
- Constant Field Values
-
EMF_KEY
@Deprecated public static final java.lang.String EMF_KEY
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.- See Also:
- Constant Field Values
-
-
Method Detail
-
cast
public static OpenJPAEntityManagerFactory cast(jakarta.persistence.EntityManagerFactory emf)
Return the OpenJPA facade to the given entity manager factory.
-
cast
public static OpenJPAEntityManager cast(jakarta.persistence.EntityManager em)
Return the OpenJPA facade to the given entity manager.
-
cast
public static OpenJPAQuery cast(jakarta.persistence.Query q)
Return the OpenJPA facade to the given query.
-
getEntityManagerFactory
public static OpenJPAEntityManagerFactory getEntityManagerFactory()
Returns theOpenJPAEntityManagerFactory
specified by your OpenJPA defaults. This method will return the same logical factory for each invocation.
-
getEntityManagerFactory
public static OpenJPAEntityManagerFactory getEntityManagerFactory(java.util.Map map)
Returns theOpenJPAEntityManagerFactory
specified by your OpenJPA defaults, usingmap
as overrides. This method will return the same logical factory for invocations with the same overrides.
-
createEntityManagerFactory
public static OpenJPAEntityManagerFactory createEntityManagerFactory(java.lang.String name, java.lang.String resource)
Returns a newOpenJPAEntityManagerFactory
specified byname
in an XML configuration file at the resource locationresource
. Ifname
isnull
, uses the first resource found in the specified location, regardless of the name specified in the XML resource or the name of the jar that the resource is contained in. Ifresource
isnull
, uses the spec-definedMETA-INF/persistence.xml
resource. This method only resolvesOpenJPAEntityManagerFactory
instances.
-
createEntityManagerFactory
public static OpenJPAEntityManagerFactory createEntityManagerFactory(java.lang.String name, java.lang.String resource, java.util.Map map)
Returns a newOpenJPAEntityManagerFactory
specified byname
in an XML configuration file at the resource locationresource
, applying the properties specified inmap
as overrides. Ifname
isnull
, uses the first resource found in the specified location, regardless of the name specified in the XML resource or the name of the jar that the resource is contained in. Ifresource
isnull
, uses the spec-definedMETA-INF/persistence.xml
resource. This method only resolvesOpenJPAEntityManagerFactory
instances.
-
createEntityManagerFactory
public static OpenJPAEntityManagerFactory createEntityManagerFactory(java.lang.String jndiLocation, javax.naming.Context context)
Returns theEntityManagerFactory
at the JNDI location specified byjndiLocation
in the contextcontext
. Ifcontext
isnull
,new InitialContext()
will be used.
-
getEntityManager
public static OpenJPAEntityManager getEntityManager(java.lang.Object o)
Return the entity manager for the given object, if one can be determined from just the object alone. This method will succeed for instances that are enhanced, that were loaded from the database (rather than being constructed withnew
), or that were created throughOpenJPAEntityManager.createInstance(java.lang.Class<T>)
.
-
close
public static void close(java.lang.Object o)
Close the given resource. The resource can be an extent iterator, query result, large result set relation, or any closeable OpenJPA component.
-
isManagedType
public static boolean isManagedType(jakarta.persistence.EntityManager em, java.lang.Class cls)
Returns true if the specified class is an entity or embeddable type.
-
toEntityManagerFactory
@Deprecated public static OpenJPAEntityManagerFactory toEntityManagerFactory(BrokerFactory factory)
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
-
toBrokerFactory
@Deprecated public static BrokerFactory toBrokerFactory(jakarta.persistence.EntityManagerFactory factory)
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
-
toEntityManager
@Deprecated public static OpenJPAEntityManager toEntityManager(Broker broker)
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
-
toBroker
@Deprecated public static Broker toBroker(jakarta.persistence.EntityManager em)
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
-
getMetaData
@Deprecated public static ClassMetaData getMetaData(java.lang.Object o)
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
-
getMetaData
@Deprecated public static ClassMetaData getMetaData(jakarta.persistence.EntityManager em, java.lang.Class cls)
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
-
getMetaData
@Deprecated public static ClassMetaData getMetaData(jakarta.persistence.EntityManagerFactory factory, java.lang.Class cls)
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
-
fromOpenJPAObjectId
@Deprecated public static java.lang.Object fromOpenJPAObjectId(java.lang.Object oid)
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
-
toOpenJPAObjectId
@Deprecated public static java.lang.Object toOpenJPAObjectId(ClassMetaData meta, java.lang.Object oid)
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
-
toOpenJPAObjectIds
@Deprecated public static java.lang.Object[] toOpenJPAObjectIds(ClassMetaData meta, java.lang.Object... oids)
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
-
toOpenJPAObjectIds
@Deprecated public static java.util.Collection toOpenJPAObjectIds(ClassMetaData meta, java.util.Collection oids)
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
-
fromOpenJPAObjectIdClass
@Deprecated public static java.lang.Class fromOpenJPAObjectIdClass(java.lang.Class oidClass)
Deprecated.useJPAFacadeHelper
instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
-
-