org.opensaml.storage.impl

Class JPAStorageService

java.lang.Object

net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

net.shibboleth.utilities.java.support.component.AbstractIdentifiableInitializableComponent

org.opensaml.storage.AbstractStorageService

org.opensaml.storage.impl.JPAStorageService

All Implemented Interfaces:

net.shibboleth.utilities.java.support.component.Component, net.shibboleth.utilities.java.support.component.DestructableComponent, net.shibboleth.utilities.java.support.component.IdentifiableComponent, net.shibboleth.utilities.java.support.component.IdentifiedComponent, net.shibboleth.utilities.java.support.component.InitializableComponent, StorageCapabilities, StorageCapabilitiesEx, StorageService

public class JPAStorageService
extends AbstractStorageService
implements StorageCapabilitiesEx

Implementation of StorageService that uses JPA to persist to a database.

Field Summary

Fields

Modifier and Type	Field and Description
private EntityManagerFactory	entityManagerFactory Entity manager factory.
private Logger	log Class logger.
private int	transactionRetry Number of times to retry a transaction if it rolls back.

Constructor Summary

Constructors

Constructor and Description
JPAStorageService(EntityManagerFactory factory) Creates a new JPA storage service.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	create(String context, String key, String value, Long expiration)
boolean	delete(String context, String key)
void	deleteContext(String context)
protected void	deleteContextImpl(String context, Long expiration) Deletes every record with the supplied context.
protected void	deleteImpl(Long expiration) Deletes every record with an expiration before the supplied expiration.
protected boolean	deleteImpl(Long version, String context, String key) Deletes the record matching the supplied parameters.
boolean	deleteWithVersion(long version, String context, String key)
protected void	doDestroy()
private <T> List<T>	executeNamedQuery(EntityManager manager, String query, Map<String,Object> params, Class<T> clazz, LockModeType lockMode) Executes the supplied named query.
protected TimerTask	getCleanupTask()
int	getTransactionRetry() Returns the number of times a transaction will be retried if a RollbackException is encountered.
boolean	isClustered()
boolean	isServerSide()
StorageRecord	read(String context, String key)
net.shibboleth.utilities.java.support.collection.Pair<Long,StorageRecord>	read(String context, String key, long version)
List<StorageRecord>	readAll() Returns all records from the store.
List<StorageRecord>	readAll(String context) Returns all records from the store for the supplied context.
List<String>	readContexts() Returns all contexts from the store.
protected net.shibboleth.utilities.java.support.collection.Pair<Long,StorageRecord>	readImpl(String context, String key, Long version) Reads the record matching the supplied parameters.
void	reap(String context)
void	setTransactionRetry(int retry) Sets the number of times a transaction will be retried.
boolean	update(String context, String key, String value, Long expiration)
void	updateContextExpiration(String context, Long expiration)
boolean	updateExpiration(String context, String key, Long expiration)
protected Long	updateImpl(Long version, String context, String key, String value, Long expiration) Updates the record matching the supplied parameters.
Long	updateWithVersion(long version, String context, String key, String value, Long expiration)

Methods inherited from class org.opensaml.storage.AbstractStorageService

create, create, delete, deleteWithVersion, doInitialize, getCapabilities, getCleanupInterval, getCleanupTaskTimer, getContextSize, getKeySize, getValueSize, read, setCleanupInterval, setCleanupTaskTimer, setContextSize, setKeySize, setValueSize, update, update, updateExpiration, updateWithVersion, updateWithVersion

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractIdentifiableInitializableComponent

setId

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

getId

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

destroy, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opensaml.storage.StorageCapabilities

getContextSize, getKeySize, getValueSize

Methods inherited from interface net.shibboleth.utilities.java.support.component.IdentifiedComponent

getId

Field Detail

log

@Nonnull
private final Logger log

Class logger.

entityManagerFactory

@Nonnull
private final EntityManagerFactory entityManagerFactory

Entity manager factory.

transactionRetry

@NonNegative
private int transactionRetry

Number of times to retry a transaction if it rolls back. Default value is .

Constructor Detail

JPAStorageService

public JPAStorageService(@Nonnull
                 EntityManagerFactory factory)

Creates a new JPA storage service.

Parameters:

factory - entity manager factory

Method Detail

getTransactionRetry

public int getTransactionRetry()

Returns the number of times a transaction will be retried if a RollbackException is encountered.

Returns:

number of transaction retries

setTransactionRetry

public void setTransactionRetry(int retry)

Sets the number of times a transaction will be retried.

Parameters:

retry - number of transaction retries

isServerSide

public boolean isServerSide()

Specified by:

isServerSide in interface StorageCapabilitiesEx

isClustered

public boolean isClustered()

Specified by:

isClustered in interface StorageCapabilitiesEx

doDestroy

protected void doDestroy()

Overrides:

doDestroy in class AbstractStorageService

create

public boolean create(@Nonnull@NotEmpty
             String context,
             @Nonnull@NotEmpty
             String key,
             @Nonnull@NotEmpty
             String value,
             @Nullable@Positive
             Long expiration)
               throws IOException

Specified by:

create in interface StorageService

Throws:

IOException

readAll

@Nonnull
@NonnullElements
public List<StorageRecord> readAll()
                            throws IOException

Returns all records from the store.

Returns:

all records or an empty list

Throws:

IOException - if errors occur in the read process

readAll

@Nonnull
@NonnullElements
public List<StorageRecord> readAll(@Nonnull@NotEmpty
                                                  String context)
                            throws IOException

Returns all records from the store for the supplied context.

Parameters:

context - a storage context label

Returns:

all records in the context or an empty list

Throws:

IOException - if errors occur in the read process

readContexts

@Nonnull
@NonnullElements
public List<String> readContexts()
                          throws IOException

Returns all contexts from the store.

Returns:

all contexts or an empty list

Throws:

IOException - if errors occur in the read process

read

@Nullable
public StorageRecord read(@Nonnull@NotEmpty
                          String context,
                          @Nonnull@NotEmpty
                          String key)
                   throws IOException

Specified by:

read in interface StorageService

Throws:

IOException

read

@Nonnull
public net.shibboleth.utilities.java.support.collection.Pair<Long,StorageRecord> read(@Nonnull@NotEmpty
                                                                                     String context,
                                                                                     @Nonnull@NotEmpty
                                                                                     String key,
                                                                                     @Positive
                                                                                     long version)
                                                                               throws IOException

Specified by:

read in interface StorageService

Throws:

IOException

readImpl

@Nonnull
protected net.shibboleth.utilities.java.support.collection.Pair<Long,StorageRecord> readImpl(@Nonnull@NotEmpty
                                                                                         String context,
                                                                                         @Nonnull@NotEmpty
                                                                                         String key,
                                                                                         @Positive
                                                                                         Long version)
                                                                                      throws IOException

Reads the record matching the supplied parameters. Returns an empty pair if the record cannot be found or is expired.

Parameters:

context - to search for

key - to search for

version - to match

Returns:

pair of version and storage record

Throws:

IOException - if errors occur in the read process

update

public boolean update(@Nonnull@NotEmpty
             String context,
             @Nonnull@NotEmpty
             String key,
             @Nonnull@NotEmpty
             String value,
             @Nullable@Positive
             Long expiration)
               throws IOException

Specified by:

update in interface StorageService

Throws:

IOException

updateWithVersion

@Nullable
public Long updateWithVersion(@Positive
                              long version,
                              @Nonnull@NotEmpty
                              String context,
                              @Nonnull@NotEmpty
                              String key,
                              @Nonnull@NotEmpty
                              String value,
                              @Nullable@Positive
                              Long expiration)
                       throws IOException,
                              VersionMismatchException

Specified by:

updateWithVersion in interface StorageService

Throws:

IOException

VersionMismatchException

updateExpiration

public boolean updateExpiration(@Nonnull@NotEmpty
                       String context,
                       @Nonnull@NotEmpty
                       String key,
                       @Nullable@Positive
                       Long expiration)
                         throws IOException

Specified by:

updateExpiration in interface StorageService

Throws:

IOException

updateImpl

@Nullable
protected Long updateImpl(@Nullable
                       Long version,
                       @Nonnull@NotEmpty
                       String context,
                       @Nonnull@NotEmpty
                       String key,
                       @Nonnull@NotEmpty
                       String value,
                       @Nullable@Positive
                       Long expiration)
                   throws IOException,
                          VersionMismatchException

Updates the record matching the supplied parameters. Returns null if the record cannot be found or is expired.

Parameters:

version - to check

context - to search for

key - to search for

value - to update

expiration - to update

Returns:

whether the record was updated

Throws:

IOException - if errors occur in the update process

VersionMismatchException - if the record found contains a version that does not match the parameter

deleteWithVersion

public boolean deleteWithVersion(@Positive
                        long version,
                        @Nonnull@NotEmpty
                        String context,
                        @Nonnull@NotEmpty
                        String key)
                          throws IOException,
                                 VersionMismatchException

Specified by:

deleteWithVersion in interface StorageService

Throws:

IOException

VersionMismatchException

delete

public boolean delete(@Nonnull@NotEmpty
             String context,
             @Nonnull@NotEmpty
             String key)
               throws IOException

Specified by:

delete in interface StorageService

Throws:

IOException

deleteImpl

protected boolean deleteImpl(@Nullable@Positive
                 Long version,
                 @Nonnull@NotEmpty
                 String context,
                 @Nonnull@NotEmpty
                 String key)
                      throws IOException,
                             VersionMismatchException

Deletes the record matching the supplied parameters.

Parameters:

version - to check

context - to search for

key - to search for

Returns:

whether the record was deleted

Throws:

IOException - if errors occur in the delete process

VersionMismatchException - if the record found contains a version that does not match the parameter

updateContextExpiration

public void updateContextExpiration(@Nonnull@NotEmpty
                           String context,
                           @Nullable@Positive
                           Long expiration)
                             throws IOException

Specified by:

updateContextExpiration in interface StorageService

Throws:

IOException

deleteContext

public void deleteContext(@Nonnull@NotEmpty
                 String context)
                   throws IOException

Specified by:

deleteContext in interface StorageService

Throws:

IOException

reap

public void reap(@Nonnull@NotEmpty
        String context)
          throws IOException

Specified by:

reap in interface StorageService

Throws:

IOException

deleteContextImpl

protected void deleteContextImpl(@Nonnull@NotEmpty
                     String context,
                     @Nonnull
                     Long expiration)
                          throws IOException

Deletes every record with the supplied context. If expiration is supplied, only records with an expiration before the supplied expiration will be removed.

Parameters:

context - to delete

expiration - (optional) to require for deletion

Throws:

IOException - if errors occur in the delete process

deleteImpl

protected void deleteImpl(@Nonnull
              Long expiration)
                   throws IOException

Deletes every record with an expiration before the supplied expiration.

Parameters:

expiration - of records to delete

Throws:

IOException - if errors occur in the cleanup process

executeNamedQuery

private <T> List<T> executeNamedQuery(@Nonnull
                            EntityManager manager,
                            @Nonnull@NotEmpty
                            String query,
                            @Nonnull
                            Map<String,Object> params,
                            @Nonnull
                            Class<T> clazz,
                            @Nonnull
                            LockModeType lockMode)
                           throws IOException

Executes the supplied named query.

Type Parameters:

T - type of entity to return

Parameters:

manager - to execute the query

query - to execute

params - parameters for the query

clazz - type of entity to return

lockMode - of the transaction

Returns:

query results or an empty list

Throws:

IOException - if an error occurs executing the query

getCleanupTask

@Nullable
protected TimerTask getCleanupTask()

Overrides:

getCleanupTask in class AbstractStorageService