io.appform.dropwizard.sharding.dao

Class RelationalDao<T>

java.lang.Object

io.appform.dropwizard.sharding.dao.RelationalDao<T>

All Implemented Interfaces:

ShardedDao<T>

Direct Known Subclasses:

CacheableRelationalDao

public class RelationalDao<T>
extends Object
implements ShardedDao<T>

A dao used to work with entities related to a parent shard. The parent may or maynot be physically present. A murmur 128 hash of the string parent key is used to route the save and retrieve calls from the proper shard.

Constructor Summary

Constructors

Constructor and Description
RelationalDao(List<org.hibernate.SessionFactory> sessionFactories, Class<T> entityClass, ShardCalculator<String> shardCalculator, ShardInfoProvider shardInfoProvider, TransactionObserver observer) Create a relational DAO.

Method Summary

Modifier and Type	Method and Description
long	count(String parentKey, org.hibernate.criterion.DetachedCriteria criteria)
List<Long>	countScatterGather(org.hibernate.criterion.DetachedCriteria criteria) Queries using the specified criteria across all shards and returns the counts of rows satisfying the criteria.
Optional<T>	createOrUpdate(String parentKey, org.hibernate.criterion.DetachedCriteria selectionCriteria, UnaryOperator<T> updater, Supplier<T> entityGenerator)
boolean	exists(String parentKey, Object key)
Optional<T>	get(String parentKey, Object key)
<U> U	get(String parentKey, Object key, Function<T,U> function)
protected Field	getKeyField()
LockedContext<T>	lockAndGetExecutor(String parentKey, org.hibernate.criterion.DetachedCriteria criteria)
<U> U	runInSession(String id, Function<org.hibernate.Session,U> handler)
Optional<T>	save(String parentKey, T entity)
<U> U	save(String parentKey, T entity, Function<T,U> handler)
boolean	saveAll(String parentKey, Collection<T> entities)
LockedContext<T>	saveAndGetExecutor(String parentKey, T entity)
List<T>	scatterGather(org.hibernate.criterion.DetachedCriteria criteria, int start, int numRows)
List<T>	select(String parentKey, org.hibernate.criterion.DetachedCriteria criteria, int first, int numResults)
<U> U	select(String parentKey, org.hibernate.criterion.DetachedCriteria criteria, int first, int numResults, Function<List<T>,U> handler)
boolean	update(String parentKey, org.hibernate.criterion.DetachedCriteria criteria, Function<T,T> updater)
boolean	update(String parentKey, Object id, Function<T,T> updater)
boolean	updateAll(String parentKey, int start, int numRows, org.hibernate.criterion.DetachedCriteria criteria, Function<T,T> updater)
<U> int	updateUsingQuery(LockedContext<U> lockedContext, UpdateOperationMeta updateOperationMeta)
int	updateUsingQuery(String parentKey, UpdateOperationMeta updateOperationMeta)

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.appform.dropwizard.sharding.dao.ShardedDao

getShardCalculator

Constructor Detail

RelationalDao

public RelationalDao(List<org.hibernate.SessionFactory> sessionFactories,
                     Class<T> entityClass,
                     ShardCalculator<String> shardCalculator,
                     ShardInfoProvider shardInfoProvider,
                     TransactionObserver observer)

Create a relational DAO.

Parameters:

sessionFactories - List of session factories. One for each shard.

entityClass - The class for which the dao will be used.

shardCalculator -

Method Detail

get

public Optional<T> get(String parentKey,
                       Object key)
                throws Exception

Throws:

Exception

get

public <U> U get(String parentKey,
                 Object key,
                 Function<T,U> function)

save

public Optional<T> save(String parentKey,
                        T entity)
                 throws Exception

Throws:

Exception

save

public <U> U save(String parentKey,
                  T entity,
                  Function<T,U> handler)

saveAll

public boolean saveAll(String parentKey,
                       Collection<T> entities)

createOrUpdate

public Optional<T> createOrUpdate(String parentKey,
                                  org.hibernate.criterion.DetachedCriteria selectionCriteria,
                                  UnaryOperator<T> updater,
                                  Supplier<T> entityGenerator)

update

public boolean update(String parentKey,
                      Object id,
                      Function<T,T> updater)

runInSession

public <U> U runInSession(String id,
                          Function<org.hibernate.Session,U> handler)

update

public boolean update(String parentKey,
                      org.hibernate.criterion.DetachedCriteria criteria,
                      Function<T,T> updater)

updateUsingQuery

public int updateUsingQuery(String parentKey,
                            UpdateOperationMeta updateOperationMeta)

updateUsingQuery

public <U> int updateUsingQuery(LockedContext<U> lockedContext,
                                UpdateOperationMeta updateOperationMeta)

lockAndGetExecutor

public LockedContext<T> lockAndGetExecutor(String parentKey,
                                           org.hibernate.criterion.DetachedCriteria criteria)

saveAndGetExecutor

public LockedContext<T> saveAndGetExecutor(String parentKey,
                                           T entity)

updateAll

public boolean updateAll(String parentKey,
                         int start,
                         int numRows,
                         org.hibernate.criterion.DetachedCriteria criteria,
                         Function<T,T> updater)

select

public List<T> select(String parentKey,
                      org.hibernate.criterion.DetachedCriteria criteria,
                      int first,
                      int numResults)
               throws Exception

Throws:

Exception

select

public <U> U select(String parentKey,
                    org.hibernate.criterion.DetachedCriteria criteria,
                    int first,
                    int numResults,
                    Function<List<T>,U> handler)
             throws Exception

Throws:

Exception

count

public long count(String parentKey,
                  org.hibernate.criterion.DetachedCriteria criteria)

exists

public boolean exists(String parentKey,
                      Object key)

countScatterGather

public List<Long> countScatterGather(org.hibernate.criterion.DetachedCriteria criteria)

Queries using the specified criteria across all shards and returns the counts of rows satisfying the criteria. Note: This method runs the query serially and it's usage is not recommended.

Parameters:

criteria - The select criteria

Returns:

List of counts in each shard

scatterGather

public List<T> scatterGather(org.hibernate.criterion.DetachedCriteria criteria,
                             int start,
                             int numRows)

getKeyField

protected Field getKeyField()