package com.tesora.dve.db;

/*
 * #%L
 * Tesora Inc.
 * Database Virtualization Engine
 * %%
 * Copyright (C) 2011 - 2014 Tesora Inc.
 * %%
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License, version 3,
 * as published by the Free Software Foundation.
 * 
 * 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 Affero General Public License for more details.
 * 
 * You should have received a copy of the GNU Affero General Public License
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
 * #L%
 */

import io.netty.channel.EventLoopGroup;

import java.util.Map;

import com.tesora.dve.common.catalog.StorageSite;
import com.tesora.dve.concurrent.CompletionHandle;
import com.tesora.dve.db.mysql.SetVariableSQLBuilder;
import com.tesora.dve.exceptions.PEException;
import com.tesora.dve.worker.DevXid;

public interface DBConnection extends CommandChannel {
	
	interface Factory {
		DBConnection newInstance(EventLoopGroup eventLoop,StorageSite site);
	}
	
	interface Monitor {
		void onUpdate();
	}
	
	void connect(String url, String userid, String password, long clientCapabilities) throws PEException;
	void close();

	void start(DevXid xid, CompletionHandle<Boolean> promise);
	void end(DevXid xid, CompletionHandle<Boolean> promise);
	void prepare(DevXid xid, CompletionHandle<Boolean> promise);
	void commit(DevXid xid, boolean onePhase, CompletionHandle<Boolean> promise);
	void rollback(DevXid xid, CompletionHandle<Boolean> promise);

    void updateSessionVariables(Map<String,String> desiredVariables, SetVariableSQLBuilder setBuilder, CompletionHandle<Boolean> promise);
    void setCatalog(String databaseName, CompletionHandle<Boolean> promise);

    @Deprecated
	void cancel();

	boolean hasPendingUpdate();
	boolean hasActiveTransaction();
	int getConnectionId();
}