gvSIG projects pool

/* 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 2

 * 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, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * 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.vcsgis.lib;

import java.io.File;

import java.net.URL;

import java.util.Map;

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

import org.gvsig.fmap.dal.store.jdbc.JDBCServerExplorerParameters;

import org.gvsig.fmap.dal.store.jdbc2.JDBCServerExplorer;

import org.gvsig.tools.task.SimpleTaskStatus;

import org.gvsig.vcsgis.lib.repository.VCSGisRepository;

import org.gvsig.vcsgis.lib.server.VCSGisServerController;

import org.gvsig.vcsgis.lib.workspace.VCSGisWorkspace;

import org.gvsig.vcsgis.lib.workspace.VCSGisWorkspaceDescriptor;

/**

 * @author gvSIG Teamn

 *

 */

public interface VCSGisManager {

    public static final int ERR_OK = 0;

    public static final int ERR_NO_ERROR = ERR_OK;

    public static final int ERR_DBFILE_IS_NULL = 1;

    public static final int ERR_WSEXPLORER_IS_NULL = 2;

    public static final int ERR_CANT_OPEN_WORKSPACE = 3;

    public static final int ERR_CANT_OPEN_WORKSPACE_SERVEREXPLORER = 4;

    public static final int ERR_STORE_NOT_IN_VERSION_CONTROL = 5;

    public static final int ERR_LABEL_IS_NULL = 6;

    public static final int ERR_CANT_EXECUTE_REQUEST = 7;

    public static final int ERR_CANT_BUILD_REQUEST_RESPONSE = 8;

    public static final int ERR_CANT_BUILD_REQUEST = 9;

    public static final int ERR_CANT_HANDLE_REQUEST = 10;

    public static final int ERR_CANT_INITIALIZE_REPOSITORY = 11;

    public static final int ERR_CANT_CONSUME_RESPONSE = 12;

    public static final int ERR_INVALID_DATA = 13;

    public static final int ERR_INVALID_REPOSITORY = 14;

    public static final int ERR_CANT_CREATE_TABLE = 90;

    public static final int ERR_CANT_CREATE_TABLE_CONFIG = 91;

    public static final int ERR_CANT_CREATE_TABLE_ENTITIES = 92;

    public static final int ERR_CANT_CREATE_TABLE_CHANGES = 93;

    public static final int ERR_ENTITY_ALREADY_EXISTS = 20;

    public static final int ERR_ENTITY_NOT_HAS_VCSGISCODE = 21;

    public static final int ERR_CANT_OPEN_ENTITIES = 22;

    public static final int ERR_CANT_INSERT_ENTITIES = 23;

    public static final int ERR_ENTITY_NOT_EXISTS = 24;

    public static final int ERR_CANT_RETRIEVE_ENTITIES = 25;

    public static final int ERR_CANT_ADD_ENTITY_WITHOUT_PRIMARY_KEY = 26;

    public static final int ERR_CANT_OPEN_CHANGES = 30;

    public static final int ERR_CANT_INSERT_CHANGE = 31;

    public static final int ERR_CANT_ADD_CHANGE = 32;

    public static final int ERR_CANT_OPEN_STORE = 40;

    public static final int ERR_CANT_RETRIEVE_SOURCE_FEATURES = 41;

    public static final int ERR_CANT_INSERT_FEATURES = 42;

    public static final int ERR_CANT_COMMIT = 50;

    public static final int ERR_CANT_COMMIT_WORKSPACE_OUTDATED = 51;

    public static final int ERR_CANT_COMMIT_WITH_FEATURE_CODE_BLANK = 52;

    public static final int ERR_CANT_CHECKOUT = 60;

    public static final int ERR_CANT_UPDATE_ENTITIES = 70;

    public static final int ERR_CANT_UPDATE = 80;

    public static final int ERR_CANT_PREPARE_UPDATE = 81;

    public static final int ERR_UPDATE_NEED_MERGE = 82;

    public static final int ERR_CANT_UPDATE_CLEAN = 83;

    public static final int STATE_UNMODIFIED = 0;                //BLACK

    public static final int STATE_NEW = 1;                       //GREEN

    public static final int STATE_MODIFIED = 2;                  //BLUE

    public static final int STATE_OUTDATED = 4;                  //BOLD BLACK

    public static final int STATE_OUTDATED_AND_MODIFIED = 6;     //RED

    public static final int STATE_CONFLICT = 8;                  //RED

    public static final int OP_UNKNOWN = -1;

    public static final int OP_DELETE = 0;

    public static final int OP_UPDATE = 1;

    public static final int OP_INSERT = 2;

    public static final int OP_ADD_ENTITY = 3;

    public static final String DEFAULT_DATA_TABLE = "VCSGIS_DATA";

    public static final String FEATURECODE_FIELD_NAME = "VCSGISCODE";

    /**

     * Initializes a workspace in the indicated database with the indicated 

     * label and associates it with the indicated repository.

     * 

     * It fails if a workspace is already created in that database.

     * 

     * A code will be assigned to the workspace automatically.

     * 

     * @param database in which to initialize the workspace.

     * @param repository to associate the workspace with.

     * @param label repository to associate the workspace with.

     * @param status

     * @return a error code.

     */

    public int initWorkspace(JDBCServerExplorer database, VCSGisRepository repository, String label, SimpleTaskStatus status);

    /**

     * Initializes a workspace in the H2 database associated with the 

     * indicated file with the indicated label and associating it with 

     * the indicated repository.

     * 

     * It fails if a workspace is already created in that database.

     * 

     * A code will be assigned to the workspace automatically.

     * 

     * @param dbfile file associated with database H2 in which to initialize the workspace.

     * @param repository to associate the workspace with.

     * @param label repository to associate the workspace with.

     * @param status

     * @return a error code.

     */

    public int initWorkspace(File dbfile, VCSGisRepository repository, String label, SimpleTaskStatus status);

    public VCSGisWorkspace openWorkspace(JDBCServerExplorer workspace);

    public VCSGisWorkspace openWorkspace(File wsfile);

    /**

     * Return a Map with the workspace descriptors registered in this manager.

     * 

     * The Map is indexed by the code of the workspace.

     * 

     * If the manager has not any workspace registered, return a empty Map.

     * 

     * @return the Map with the registered workspace descriptors.

     */

    public Map<String, VCSGisWorkspaceDescriptor> getWorkspaces();

    /**

     * Register a VCSGis-workspace in this manager.

     * 

     * @param workspace to register

     */

    public void registerWorkspace(VCSGisWorkspace workspace);

    /**

     * Deregister the VCSGis-workspace of this manager.

     * 

     * @param workspace to deregister

     */

    public void deregisterWorkspace(VCSGisWorkspace workspace);

    /**

     * Replace the current registered workspaces by the indicaded as the Map

     * of parameters in this manager.

     * 

     * If descriptors is null, remove al registered workspaces in this manager.

     * 

     * This method is designed to support the persistence of this manager's workspaces.

     * 

     * @param descriptors 

     */

    public void restoreWorkspaces(Map<String, VCSGisWorkspaceDescriptor> descriptors);

    /**

     * Returns the workspace associated with the store.

     * 

     * If the store is not associated with any registered workspace, it returns null.

     * 

     * The method can add properties to the store to optimize future invocations.

     * 

     * @param store

     * 

     * @return the workspace of the store or null.

     */

    public VCSGisWorkspace getWorkspace(FeatureStore store);

    /**

     * Return true if the file is a database of H2 that contains a VCSGis-workspace,

     * otherwise return false.

     * 

     * @param dbfile

     * @return 

     */

    public boolean isWorkspace(File dbfile);

    /**

     * Return true if the explorer parameters reference a database that contains a VCSGis-workspace,

     * otherwise return false.

     * 

     * @param params

     * @return 

     */

    public boolean isWorkspace(JDBCServerExplorerParameters params);

    public VCSGisWorkspaceDescriptor getWorkspaceDescriptor(String code);

    public int initRepository(JDBCServerExplorerParameters repositoryParameters, SimpleTaskStatus status);

    public VCSGisRepository openRepository(JDBCServerExplorerParameters repositoryParameters);

    public VCSGisRepository openRepository(URL repository);

    public VCSGisServerController createServerController(VCSGisRepository repository);

    public void setCodeGenerator(VCSGisCodeGenerator generator);

    public VCSGisCodeGenerator getCodeGenerator();

}