org.nuiton.topia.replication.TopiaReplicationService Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of topia-service-replication Show documentation
Hibernate based replication service
There is a newer version: 4.0
Show newest version
/*
 * #%L
 * ToPIA :: Service Replication
 * 
 * $Id: TopiaReplicationService.java 2245 2011-04-14 12:47:09Z tchemit $
 * $HeadURL: http://svn.nuiton.org/svn/topia/tags/topia-2.6.6/topia-service-replication/src/main/java/org/nuiton/topia/replication/TopiaReplicationService.java $
 * %%
 * Copyright (C) 2004 - 2010 CodeLutin
 * %%
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as 
 * published by the Free Software Foundation, either version 3 of the 
 * License, or (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Lesser Public License for more details.
 * 
 * You should have received a copy of the GNU General Lesser Public 
 * License along with this program.  If not, see
 * .
 * #L%
 */
package org.nuiton.topia.replication;

import org.nuiton.topia.TopiaContext;
import org.nuiton.topia.TopiaException;
import org.nuiton.topia.framework.TopiaService;
import org.nuiton.topia.persistence.TopiaEntityEnum;
import org.nuiton.topia.replication.model.ReplicationModel;

/**
 * User visible interface for replication engin
 * 
 * To use replicator you must have properties defined in config file:
 * 
topia.replication.engin=[class used to indexation] 
possible specific
 * property for index engin used
 * 
 * The replication is always done in two phases :
 * 

 * 
 - prepare the replication model - ({@link #prepare(TopiaEntityEnum[], boolean, String...)} - ({@link #prepareForAll(TopiaEntityEnum[])}
 * 
 *  - lanch replication {@link #doReplicate(ReplicationModel,
 * TopiaContext)}
 *
 * @author tchemit 
 * @since 2.2.0
 */
public interface TopiaReplicationService extends TopiaService {

    /**
     * Nom du service
     */
    String SERVICE_NAME = "replication";

    /**
     * Nom du service topia
     */
    String TOPIA_SERVICE_NAME = "topia.service.replication";

    /**
     * Obtains the {@code model builder} use to creat the replication's model.
     *
     * @return the model builder
     * @since 2.4.3
     */
    TopiaReplicationModelBuilder getModelBuilder();

    /**
     * Prepare le modele de replication pour les entites dans les topiaIds sont
     * donnes.
     *
     * @param contracts    les contrats a repliquer
     * @param computeOrder drapeau positionné à {@code true} si on doit calculer
     *                     l'ordre des entités à repliquer, sinon on utilise
     *                     l'ordre induit par les {@code contracts}.
     * @param topiaIds     la liste des ids d'entites a repliquer
     * @return le model de replication initialise
     * @throws TopiaException pour toute erreur recontree
     */
    ReplicationModel prepare(TopiaEntityEnum[] contracts,
                             boolean computeOrder,
                             String... topiaIds) throws TopiaException;

    /**
     * Prepare le modele de replication pour toutes les entites des types
     * donnes.
     * 
     * La méthode calcule l'ordre de replication des données.
     * 

     * Actuellement, on n'est pas capable de calculer l'ordre si le graphe des
     * entités contient des cycles.
     * 
     * TODO : faire en sorte de pouvoir gérer les cycles.
     *
     * @param contracts les contrats des types a repliquer
     * @return le modele pour la replication
     * @throws TopiaException pour toute erreur rencontree
     */
    ReplicationModel prepareForAll(TopiaEntityEnum[] contracts) throws TopiaException;

    /**
     * Lance l'operation de replication a partir du context source vers le
     * context de destination sur les entites donnees et en utilisant le modele
     * de replication precedemment construit via la methode {@link
     * #prepare(TopiaEntityEnum[], boolean, String...)} ou {@link
     * #prepareForAll(TopiaEntityEnum[])}.
     *
     * @param model   le modele de replication
     * @param dstCtxt le context sur la source de donnees ou repliquer
     * @throws Exception pour toute erreur pendant la replication
     */
    void doReplicate(ReplicationModel model,
                     TopiaContext dstCtxt) throws Exception;

    /**
     * Pour revenir en arrière lorsque la réplication a échouée .
     *
     * @param replicationContext the replication's context used to start replication.
     * @throws Exception pour toute erreur pendant la replication
     */
    void doRollback(TopiaReplicationContext replicationContext) throws Exception;
}