EMFProviderInterface (SmartClient Enterprise Server API 14.0d (2024-11-01))

All Known Implementing Classes:

EMFProviderBMT, EMFProviderCMT, EMFProviderLMT, EMFProviderNoTransactions, EMFProviderSpring
```
public interface EMFProviderInterface
```
Interface used to provide specific implementation of EntityManager and transaction acquiring and handling.
Implementation of this interface should provide at least two constructors:
1. default constructor - will be used if implementation is used as default EMF provider
2. constructor with single parameter of type Properties - will be used if implementation is used as additional named EMF provider

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`ENTITY_MANAGER` Name of sub property for resource reference to entity manager.
`static java.lang.String`	`ENTITY_MANAGER_FACTORY` Name of sub property for resource reference to entity manager factory.
`static java.lang.String`	`JPA_ENTITY_MANAGER` Name of property for resource reference to entity manager.
`static java.lang.String`	`JPA_ENTITY_MANAGER_FACTORY` Name of property for resource reference to entity manager factory.
`static java.lang.String`	`JPA_PERSISTENCE_UNIT_NAME` Name of property for persistence unit name.
`static java.lang.String`	`JPA_TRANSACTION` Name of property for resource reference to transaction or transaction manager.
`static java.lang.String`	`PERSISTENCE_UNIT_NAME` Name of sub property for persistence unit name.
`static java.lang.String`	`TRANSACTION` Name of sub property for resource reference to transaction or transaction manager.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`commitTransaction(java.lang.Object tx)` Commits specified transaction.
`javax.persistence.EntityManagerFactory`	`get()` Returns `EntityManagerFactory`.
`javax.persistence.EntityManager`	`getEntityManager()` Returns `EntityManager` for persistence operations.
`java.lang.Object`	`getTransaction(javax.persistence.EntityManager em)` Returns started transaction.
`void`	`returnEntityManager(javax.persistence.EntityManager em)` Closes `EntityManager`.
`void`	`rollbackTransaction(java.lang.Object tx)` Rolls back specified transaction.

- Field Detail
  - PERSISTENCE_UNIT_NAME
```
static final java.lang.String PERSISTENCE_UNIT_NAME
```
    Name of sub property for persistence unit name.
    
    See Also:
    
    Constant Field Values
  - JPA_PERSISTENCE_UNIT_NAME
```
static final java.lang.String JPA_PERSISTENCE_UNIT_NAME
```
    Name of property for persistence unit name.
    
    See Also:
    
    Constant Field Values
  - ENTITY_MANAGER
```
static final java.lang.String ENTITY_MANAGER
```
    Name of sub property for resource reference to entity manager.
    
    See Also:
    
    Constant Field Values
  - JPA_ENTITY_MANAGER
```
static final java.lang.String JPA_ENTITY_MANAGER
```
    Name of property for resource reference to entity manager.
    
    See Also:
    
    Constant Field Values
  - ENTITY_MANAGER_FACTORY
```
static final java.lang.String ENTITY_MANAGER_FACTORY
```
    Name of sub property for resource reference to entity manager factory.
    
    See Also:
    
    Constant Field Values
  - JPA_ENTITY_MANAGER_FACTORY
```
static final java.lang.String JPA_ENTITY_MANAGER_FACTORY
```
    Name of property for resource reference to entity manager factory.
    
    See Also:
    
    Constant Field Values
  - TRANSACTION
```
static final java.lang.String TRANSACTION
```
    Name of sub property for resource reference to transaction or transaction manager.
    
    See Also:
    
    Constant Field Values
  - JPA_TRANSACTION
```
static final java.lang.String JPA_TRANSACTION
```
    Name of property for resource reference to transaction or transaction manager.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - get
```
javax.persistence.EntityManagerFactory get()
```
    Returns EntityManagerFactory.
    
    Returns:
    
    EntityManagerFactory.
  - getEntityManager
```
javax.persistence.EntityManager getEntityManager()
                                          throws javax.persistence.PersistenceException
```
    Returns EntityManager for persistence operations.
    
    Returns:
    
    EntityManager for persistence operations.
    
    Throws:
    
    javax.persistence.PersistenceException - if unable to acquire EntityManager.
  - returnEntityManager
```
void returnEntityManager(javax.persistence.EntityManager em)
```
    Closes EntityManager.
    
    Parameters:
    
    em - EntityManager which should be closed.
  - getTransaction
```
java.lang.Object getTransaction(javax.persistence.EntityManager em)
                         throws java.lang.Exception
```
    Returns started transaction.
    
    Parameters:
    
    em - EntityManager needed if joining to existing transaction or starting transaction locally.
    
    Returns:
    
    Object Already started transaction for persistence operations.
    
    Throws:
    
    java.lang.Exception - if unable to acquire or open transaction.
  - commitTransaction
```
void commitTransaction(java.lang.Object tx)
                throws java.lang.Exception
```
    Commits specified transaction.
    
    Parameters:
    
    tx - Object transaction to be commited.
    
    Throws:
    
    java.lang.Exception - occured while committing transaction.
  - rollbackTransaction
```
void rollbackTransaction(java.lang.Object tx)
```
    Rolls back specified transaction.
    
    Parameters:
    
    tx - Object transaction to be rolled back.

Interface EMFProviderInterface

Field Summary

Method Summary

Field Detail

PERSISTENCE_UNIT_NAME

JPA_PERSISTENCE_UNIT_NAME

ENTITY_MANAGER

JPA_ENTITY_MANAGER

ENTITY_MANAGER_FACTORY

JPA_ENTITY_MANAGER_FACTORY

TRANSACTION

JPA_TRANSACTION

Method Detail

get

getEntityManager

returnEntityManager

getTransaction

commitTransaction

rollbackTransaction