org.apache.openjpa.persistence
Class OpenJPAPersistence

java.lang.Object
  extended by org.apache.openjpa.persistence.OpenJPAPersistence

public class OpenJPAPersistence
extends Object

Static helper methods for JPA users.

Since:
0.4.0
Author:
Abe White

Field Summary
static String EM_KEY
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
static String EMF_KEY
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
 
Constructor Summary
OpenJPAPersistence()
           
 
Method Summary
static OpenJPAEntityManager cast(EntityManager em)
          Return the OpenJPA facade to the given entity manager.
static OpenJPAEntityManagerFactory cast(EntityManagerFactory emf)
          Return the OpenJPA facade to the given entity manager factory.
static OpenJPAQuery cast(Query q)
          Return the OpenJPA facade to the given query.
static void close(Object o)
          Close the given resource.
static OpenJPAEntityManagerFactory createEntityManagerFactory(String jndiLocation, Context context)
          Returns the EntityManagerFactory at the JNDI location specified by jndiLocation in the context context.
static OpenJPAEntityManagerFactory createEntityManagerFactory(String name, String resource)
          Returns a new OpenJPAEntityManagerFactory specified by name in an XML configuration file at the resource location resource.
static OpenJPAEntityManagerFactory createEntityManagerFactory(String name, String resource, Map map)
          Returns a new OpenJPAEntityManagerFactory specified by name in an XML configuration file at the resource location resource, applying the properties specified in map as overrides.
static Object fromOpenJPAObjectId(Object oid)
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
static Class fromOpenJPAObjectIdClass(Class oidClass)
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
static OpenJPAEntityManager getEntityManager(Object o)
          Return the entity manager for the given object, if one can be determined from just the object alone.
static OpenJPAEntityManagerFactory getEntityManagerFactory()
          Returns the OpenJPAEntityManagerFactory specified by your OpenJPA defaults.
static OpenJPAEntityManagerFactory getEntityManagerFactory(Map map)
          Returns the OpenJPAEntityManagerFactory specified by your OpenJPA defaults, using map as overrides.
static ClassMetaData getMetaData(EntityManager em, Class cls)
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
static ClassMetaData getMetaData(EntityManagerFactory factory, Class cls)
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
static ClassMetaData getMetaData(Object o)
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
static boolean isManagedType(EntityManager em, Class cls)
          Returns true if the specified class is an entity or embeddable type.
static Broker toBroker(EntityManager em)
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
static BrokerFactory toBrokerFactory(EntityManagerFactory factory)
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
static OpenJPAEntityManager toEntityManager(Broker broker)
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
static OpenJPAEntityManagerFactory toEntityManagerFactory(BrokerFactory factory)
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
static Object toOpenJPAObjectId(ClassMetaData meta, Object oid)
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
static Collection toOpenJPAObjectIds(ClassMetaData meta, Collection oids)
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
static Object[] toOpenJPAObjectIds(ClassMetaData meta, Object... oids)
          Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

EM_KEY

public static final String EM_KEY
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
See Also:
Constant Field Values

EMF_KEY

public static final String EMF_KEY
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.
See Also:
Constant Field Values
Constructor Detail

OpenJPAPersistence

public OpenJPAPersistence()
Method Detail

cast

public static OpenJPAEntityManagerFactory cast(EntityManagerFactory emf)
Return the OpenJPA facade to the given entity manager factory.


cast

public static OpenJPAEntityManager cast(EntityManager em)
Return the OpenJPA facade to the given entity manager.


cast

public static OpenJPAQuery cast(Query q)
Return the OpenJPA facade to the given query.


getEntityManagerFactory

public static OpenJPAEntityManagerFactory getEntityManagerFactory()
Returns the OpenJPAEntityManagerFactory specified by your OpenJPA defaults. This method will return the same logical factory for each invocation.


getEntityManagerFactory

public static OpenJPAEntityManagerFactory getEntityManagerFactory(Map map)
Returns the OpenJPAEntityManagerFactory specified by your OpenJPA defaults, using map as overrides. This method will return the same logical factory for invocations with the same overrides.


createEntityManagerFactory

public static OpenJPAEntityManagerFactory createEntityManagerFactory(String name,
                                                                     String resource)
Returns a new OpenJPAEntityManagerFactory specified by name in an XML configuration file at the resource location resource. If name is null, 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. If resource is null, uses the spec-defined META-INF/persistence.xml resource. This method only resolves OpenJPAEntityManagerFactory instances.


createEntityManagerFactory

public static OpenJPAEntityManagerFactory createEntityManagerFactory(String name,
                                                                     String resource,
                                                                     Map map)
Returns a new OpenJPAEntityManagerFactory specified by name in an XML configuration file at the resource location resource, applying the properties specified in map as overrides. If name is null, 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. If resource is null, uses the spec-defined META-INF/persistence.xml resource. This method only resolves OpenJPAEntityManagerFactory instances.


createEntityManagerFactory

public static OpenJPAEntityManagerFactory createEntityManagerFactory(String jndiLocation,
                                                                     Context context)
Returns the EntityManagerFactory at the JNDI location specified by jndiLocation in the context context. If context is null, new InitialContext() will be used.


getEntityManager

public static OpenJPAEntityManager getEntityManager(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 with new), or that were created through OpenJPAEntityManager.createInstance(java.lang.Class).


close

public static void close(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(EntityManager em,
                                    Class cls)
Returns true if the specified class is an entity or embeddable type.


toEntityManagerFactory

public static OpenJPAEntityManagerFactory toEntityManagerFactory(BrokerFactory factory)
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.


toBrokerFactory

public static BrokerFactory toBrokerFactory(EntityManagerFactory factory)
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.


toEntityManager

public static OpenJPAEntityManager toEntityManager(Broker broker)
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.


toBroker

public static Broker toBroker(EntityManager em)
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.


getMetaData

public static ClassMetaData getMetaData(Object o)
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.


getMetaData

public static ClassMetaData getMetaData(EntityManager em,
                                        Class cls)
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.


getMetaData

public static ClassMetaData getMetaData(EntityManagerFactory factory,
                                        Class cls)
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.


fromOpenJPAObjectId

public static Object fromOpenJPAObjectId(Object oid)
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.


toOpenJPAObjectId

public static Object toOpenJPAObjectId(ClassMetaData meta,
                                       Object oid)
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.


toOpenJPAObjectIds

public static Object[] toOpenJPAObjectIds(ClassMetaData meta,
                                          Object... oids)
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.


toOpenJPAObjectIds

public static Collection toOpenJPAObjectIds(ClassMetaData meta,
                                            Collection oids)
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.


fromOpenJPAObjectIdClass

public static Class fromOpenJPAObjectIdClass(Class oidClass)
Deprecated. use JPAFacadeHelper instead. This method pierces the published-API boundary, as does the JPAFacadeHelper utilization.



Copyright © 2006-2008 Apache Software Foundation. All Rights Reserved.