Application: gvSIG desktop

/*

 * gvSIG. Desktop Geographic Information System.

 * 

 * Copyright (C) 2007-2020 gvSIG Association.

 * 

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU 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 Public License for more details.

 * 

 * You should have received a copy of the GNU General Public License 

 * along with this program. If not, see <https://www.gnu.org/licenses/>. 

 * 

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.fmap.dal;

import org.gvsig.fmap.dal.exception.DataException;

import org.gvsig.fmap.dal.feature.FeatureStore;

import org.gvsig.tools.dispose.Disposable;

import org.gvsig.tools.observer.Observable;

/**

 *

 * @author gvSIG Team

 */

public interface DataTransaction extends Disposable, AutoCloseable, Observable {

    public static void rollbackQuietly(DataTransaction transaction) {

        if( transaction == null ) {

            return;

        }

        transaction.rollbackQuietly();

    }

    public static void close(DataTransaction transaction) {

        if( transaction == null ) {

            return;

        }

        try {

            transaction.close();

        } catch (RuntimeException ex) {

            throw ex;

        } catch (Exception ex) {

            //Por aqu? no deber?a pasar

            throw new RuntimeException("Can't close transaction", ex);

        }

    }

    public static void add(DataTransaction transaction, DataServerExplorer explorer) throws DataException {

        if (transaction == null) {

            return;

        }

        transaction.add(explorer);

    }

    public static void add(DataTransaction transaction, DataServerExplorer explorer, boolean local) throws DataException {

        if (transaction == null) {

            return;

        }

        transaction.add(explorer, local);

    }

    public static void add(DataTransaction transaction, FeatureStore store, boolean local) throws DataException {

        if (transaction == null) {

            return;

        }

        transaction.add(store, local);

    }

    public String getCode();

    public void begin() throws DataException;

    public void commit() throws DataException;

    public void rollback() throws DataException;

    public void rollbackQuietly();

    public void add(DataStore store) throws DataException;

    /**

     * Add store to transaction. 

     * If local is true, the store will be disposed at finish transaction

     */

    public void add(DataStore store, boolean local) throws DataException;

    public void add(DataServerExplorer explorer) throws DataException;

    public void add(DataServerExplorer explorer, boolean local) throws DataException;

    public void add(Disposable resource) throws DataException;

    public void add(DataServerExplorer explorer, String id);

    public void add(DataServerExplorer explorer, String id, boolean local);

    public void add(DataStore store, String id);

    public void add(DataStore store, String id, boolean local);

    public void add(SupportTransactions obj, boolean local) throws DataException;

    public void remove(DataStore store) throws DataException;

    public void remove(DataServerExplorer serverExplorer);

    public boolean isInProgress();

    public boolean contains(DataServerExplorer explorer);

    public boolean contains(DataStore store);

    public FeatureStore getFeatureStore(String id);

    public DataServerExplorer getServerExplorer(String id);

}