org.microbean.jpa.weld

Class JpaInjectionServices

java.lang.Object

org.microbean.jpa.weld.JpaInjectionServices

All Implemented Interfaces:

Service, JpaInjectionServices

@Issue(id="WELD-2563",
       uri="https://issues.jboss.org/browse/WELD-2563")
public final class JpaInjectionServices
extends Object
implements JpaInjectionServices

A JpaInjectionServices implementation that integrates JPA functionality into Weld-based CDI environments.

Author:

Laird Nelson

See Also:

JpaInjectionServices

Constructor Summary

Constructors

Constructor and Description
JpaInjectionServices() Creates a new JpaInjectionServices.

Method Summary

Modifier and Type	Method and Description
void	cleanup() Invoked by Weld automatically to clean up any resources held by this class.
ResourceReferenceFactory<EntityManager>	registerPersistenceContextInjectionPoint(InjectionPoint injectionPoint) Returns a ResourceReferenceFactory whose ResourceReferenceFactory.createResource() method will be invoked appropriately by Weld later.
ResourceReferenceFactory<EntityManagerFactory>	registerPersistenceUnitInjectionPoint(InjectionPoint injectionPoint) Returns a ResourceReferenceFactory whose ResourceReferenceFactory.createResource() method will be invoked appropriately by Weld later.
EntityManager	resolvePersistenceContext(InjectionPoint injectionPoint) Deprecated. See the documentation for the JpaInjectionServices.resolvePersistenceContext(InjectionPoint) method.
EntityManagerFactory	resolvePersistenceUnit(InjectionPoint injectionPoint) Deprecated. See the documentation for the JpaInjectionServices.resolvePersistenceUnit(InjectionPoint) method.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JpaInjectionServices

public JpaInjectionServices()

Creates a new JpaInjectionServices.

Method Detail

registerPersistenceContextInjectionPoint

public final ResourceReferenceFactory<EntityManager> registerPersistenceContextInjectionPoint(InjectionPoint injectionPoint)

Returns a ResourceReferenceFactory whose ResourceReferenceFactory.createResource() method will be invoked appropriately by Weld later.

This method never returns null.

Specified by:

registerPersistenceContextInjectionPoint in interface JpaInjectionServices

Parameters:

injectionPoint - the InjectionPoint annotated with PersistenceContext; must not be null

Returns:

a non-null ResourceReferenceFactory whose ResourceReferenceFactory.createResource() method will create EntityManager instances

Throws:

NullPointerException - if injectionPoint is null

See Also:

ResourceReferenceFactory.createResource()

registerPersistenceUnitInjectionPoint

public final ResourceReferenceFactory<EntityManagerFactory> registerPersistenceUnitInjectionPoint(InjectionPoint injectionPoint)

Returns a ResourceReferenceFactory whose ResourceReferenceFactory.createResource() method will be invoked appropriately by Weld later.

This method never returns null.

Specified by:

registerPersistenceUnitInjectionPoint in interface JpaInjectionServices

Parameters:

injectionPoint - the InjectionPoint annotated with PersistenceUnit; must not be null

Returns:

a non-null ResourceReferenceFactory whose ResourceReferenceFactory.createResource() method will create EntityManagerFactory instances

Throws:

NullPointerException - if injectionPoint is null

See Also:

ResourceReferenceFactory.createResource()

cleanup

public final void cleanup()

Invoked by Weld automatically to clean up any resources held by this class.

Specified by:

cleanup in interface Service

resolvePersistenceContext

@Deprecated
public final EntityManager resolvePersistenceContext(InjectionPoint injectionPoint)

Deprecated. See the documentation for the JpaInjectionServices.resolvePersistenceContext(InjectionPoint) method.

Calls the registerPersistenceContextInjectionPoint(InjectionPoint) method and invokes ResourceReference.getInstance() on its return value and returns the result.

This method never returns null.

Specified by:

resolvePersistenceContext in interface JpaInjectionServices

Parameters:

injectionPoint - an InjectionPoint annotated with PersistenceContext; must not be null

Returns:

a non-null EntityManager

See Also:

registerPersistenceContextInjectionPoint(InjectionPoint)

resolvePersistenceUnit

@Deprecated
public final EntityManagerFactory resolvePersistenceUnit(InjectionPoint injectionPoint)

Deprecated. See the documentation for the JpaInjectionServices.resolvePersistenceUnit(InjectionPoint) method.

Calls the registerPersistenceUnitInjectionPoint(InjectionPoint) method and invokes ResourceReference.getInstance() on its return value and returns the result.

This method never returns null.

Specified by:

resolvePersistenceUnit in interface JpaInjectionServices

Parameters:

injectionPoint - an InjectionPoint annotated with PersistenceUnit; must not be null

Returns:

a non-null EntityManagerFactory

See Also:

registerPersistenceUnitInjectionPoint(InjectionPoint)