org.nuiton.topia

Interface TopiaReplicationSupport

All Known Subinterfaces:

TopiaContext, TopiaContextImplementor

All Known Implementing Classes:

AbstractTopiaContext

public interface TopiaReplicationSupport

This API provides methods about entities replication

Since:

3.0

Author:

Arnaud Thimel

Method Summary

Methods

Modifier and Type	Method and Description
void	replicate(TopiaContext destinationContext, Object... entityAndCondition) Makes a replication of some entities from this context to the given context without any entity modification.
<T extends TopiaEntity> void	replicateEntities(TopiaContext destinationContext, List<T> entities) Makes a replication of some entities from this context to the given context without any entity modification.
<T extends TopiaEntity> void	replicateEntity(TopiaContext destinationContext, T entity) Replicate a given entity from this context to the given context.

Method Detail

replicate

void replicate(TopiaContext destinationContext,
             Object... entityAndCondition)
               throws IllegalArgumentException

Makes a replication of some entities from this context to the given context without any entity modification.

Note: If the entityAndCondition parameter is empty, all the database will be replicated

Note 2: The simple replication may not be sufficent. You may want to replicate only a part of some entities : use the method replicateEntities(TopiaContext, java.util.List).

Parameters:

destinationContext - the destination context

entityAndCondition - [key;value;...] parameter which key is the entity class to replicate, and value the "where" condition to use when querying entities

Throws:

IllegalArgumentException - if one of the context is closed or if trying to replicate within the same database

replicateEntity

<T extends TopiaEntity> void replicateEntity(TopiaContext destinationContext,
                                           T entity)
                     throws IllegalArgumentException

Replicate a given entity from this context to the given context.

Parameters:

destinationContext - the destination context

entity - the entity instance to replicate

Throws:

IllegalArgumentException - if one of the context is closed or if trying to replicate within the same database

replicateEntities

<T extends TopiaEntity> void replicateEntities(TopiaContext destinationContext,
                                             List<T> entities)
                       throws IllegalArgumentException

Makes a replication of some entities from this context to the given context without any entity modification.

Parameters:

destinationContext - the destination context

entities - the list of entities instance to replicate

Throws:

IllegalArgumentException - if one of the context is closed or if trying to replicate within the same database