org.springframework.data.jpa.provider

Enum PersistenceProvider

java.lang.Object

java.lang.Enum<PersistenceProvider>

org.springframework.data.jpa.provider.PersistenceProvider

All Implemented Interfaces:

Serializable, Comparable<PersistenceProvider>, ProxyIdAccessor, QueryExtractor

public enum PersistenceProvider
extends Enum<PersistenceProvider>
implements QueryExtractor, ProxyIdAccessor

Enumeration representing persistence providers to be used.

Author:

Oliver Gierke, Thomas Darimont

Enum Constant Summary

Enum Constants

Enum Constant and Description
ECLIPSELINK EclipseLink persistence provider.
GENERIC_JPA Unknown special provider.
HIBERNATE Hibernate persistence provider.
OPEN_JPA OpenJpa persistence provider.

Method Summary

Modifier and Type	Method and Description
boolean	canExtractQuery() Returns whether the extractor is able to extract the original query string from a given Query.
CloseableIterator<Object>	executeQueryWithResultStream(javax.persistence.Query jpaQuery)
static PersistenceProvider	fromEntityManager(javax.persistence.EntityManager em) Determines the PersistenceProvider from the given EntityManager.
static PersistenceProvider	fromMetamodel(javax.persistence.metamodel.Metamodel metamodel) Determines the PersistenceProvider from the given Metamodel.
String	getCountQueryPlaceholder() Returns the placeholder to be used for simple count queries.
<T> Collection<T>	potentiallyConvertEmptyCollection(Collection<T> collection) Potentially converts an empty collection to the appropriate representation of this PersistenceProvider, since some JPA providers cannot correctly handle empty collections.
static PersistenceProvider	valueOf(String name) Returns the enum constant of this type with the specified name.
static PersistenceProvider[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.springframework.data.jpa.provider.QueryExtractor

extractQueryString

Methods inherited from interface org.springframework.data.jpa.provider.ProxyIdAccessor

getIdentifierFrom, shouldUseAccessorFor

Enum Constant Detail

HIBERNATE

public static final PersistenceProvider HIBERNATE

Hibernate persistence provider.

Since Hibernate 4.3 the location of the HibernateEntityManager moved to the org.hibernate.jpa package. In order to support both locations we interpret both classnames as a Hibernate PersistenceProvider.

See Also:

DATAJPA-444

ECLIPSELINK

public static final PersistenceProvider ECLIPSELINK

EclipseLink persistence provider.

OPEN_JPA

public static final PersistenceProvider OPEN_JPA

OpenJpa persistence provider.

GENERIC_JPA

public static final PersistenceProvider GENERIC_JPA

Unknown special provider. Use standard JPA.

Method Detail

values

public static PersistenceProvider[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (PersistenceProvider c : PersistenceProvider.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static PersistenceProvider valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

fromEntityManager

public static PersistenceProvider fromEntityManager(javax.persistence.EntityManager em)

Determines the PersistenceProvider from the given EntityManager. If no special one can be determined GENERIC_JPA will be returned.

Parameters:

em - must not be null.

Returns:

will never be null.

fromMetamodel

public static PersistenceProvider fromMetamodel(javax.persistence.metamodel.Metamodel metamodel)

Determines the PersistenceProvider from the given Metamodel. If no special one can be determined GENERIC_JPA will be returned.

Parameters:

metamodel - must not be null.

Returns:

will never be null.

canExtractQuery

public boolean canExtractQuery()

Description copied from interface: QueryExtractor

Returns whether the extractor is able to extract the original query string from a given Query.

Specified by:

canExtractQuery in interface QueryExtractor

Returns:

getCountQueryPlaceholder

public String getCountQueryPlaceholder()

Returns the placeholder to be used for simple count queries. Default implementation returns *.

Returns:

potentiallyConvertEmptyCollection

public <T> Collection<T> potentiallyConvertEmptyCollection(Collection<T> collection)

Potentially converts an empty collection to the appropriate representation of this PersistenceProvider, since some JPA providers cannot correctly handle empty collections.

Parameters:

collection -

Returns:

See Also:

DATAJPA-606

executeQueryWithResultStream

public CloseableIterator<Object> executeQueryWithResultStream(javax.persistence.Query jpaQuery)