teichmann@5861: /* Copyright (C) 2011, 2012, 2013 by Bundesanstalt für Gewässerkunde
teichmann@5861:  * Software engineering by Intevation GmbH
teichmann@5861:  *
teichmann@5861:  * This file is Free Software under the GNU AGPL (>=v3) 
teichmann@5861:  * and comes with ABSOLUTELY NO WARRANTY! Check out the
teichmann@5861:  * documentation coming with Dive4Elements River for details. 
teichmann@5861:  */
teichmann@5861: 
teichmann@5835: package org.dive4elements.river.client.client.services;
ingo@32: 
ingo@32: import com.google.gwt.user.client.rpc.RemoteService;
ingo@32: import com.google.gwt.user.client.rpc.RemoteServiceRelativePath;
ingo@32: 
teichmann@5835: import org.dive4elements.river.client.shared.exceptions.ServerException;
teichmann@5835: import org.dive4elements.river.client.shared.model.Artifact;
teichmann@5835: import org.dive4elements.river.client.shared.model.Data;
ingo@32: 
ingo@32: /**
felix@852:  * This interface provides artifact specific operations FEED and ADVANCE.
ingo@32:  *
ingo@32:  * @author <a href="mailto:ingo.weinzierl@intevation.de">Ingo Weinzierl</a>
ingo@32:  */
ingo@32: @RemoteServiceRelativePath("forward")
ingo@32: public interface StepForwardService extends RemoteService {
ingo@32: 
ingo@32:     /**
felix@852:      * This method inserts new data into the an existing artifact and
felix@852:      * advances its state.
ingo@32:      *
ingo@229:      * @param locale The locale used for the request.
ingo@32:      * @param artifact The artifact.
ingo@32:      * @param data The data that should be inserted.
ingo@32:      *
ingo@32:      * @return the artifact which description might have been changed.
ingo@32:      */
ingo@229:     public Artifact go(
ingo@229:         String   locale,
ingo@229:         Artifact artifact,
ingo@229:         Data[]   data)
ingo@215:     throws ServerException;
ingo@32: }
ingo@32: // vim:set ts=4 sw=4 si et sta sts=4 fenc=utf8 :