/*
 * This file is part of gtkD.
 *
 * gtkD 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, with
 * some exceptions, please read the COPYING file.
 *
 * gtkD 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 Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with gtkD; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
 */
 
// generated automatically - do not change
// find conversion definition on APILookup.txt
// implement new conversion functionalities on the wrap.utils pakage

/*
 * Conversion parameters:
 * inFile  = libgda-GdaClient.html
 * outPack = gda
 * outFile = Client
 * strct   = GdaClient
 * realStrct=
 * ctorStrct=
 * clss    = Client
 * interf  = 
 * class Code: Yes
 * interface Code: No
 * template for:
 * extend  = GObject
 * implements:
 * prefixes:
 * 	- gda_client_
 * omit structs:
 * omit prefixes:
 * omit code:
 * 	- gda_client_open_connection
 * omit signals:
 * imports:
 * 	- glib.Str
 * 	- glib.ListG
 * 	- gda.Connection
 * 	- gda.ErrorGda
 * 	- gda.ParameterList
 * 	- gda.Transaction
 * structWrap:
 * 	- GList* -> ListG
 * 	- GdaConnection* -> Connection
 * 	- GdaError* -> ErrorGda
 * 	- GdaParameterList* -> ParameterList
 * 	- GdaTransaction* -> Transaction
 * module aliases:
 * local aliases:
 * overrides:
 */

module gda.Client;

public  import gdac.gdatypes;

private import gdac.gda;
private import glib.ConstructionException;
private import gobject.ObjectG;


private import glib.Str;
private import glib.ListG;
private import gda.Connection;
private import gda.ErrorGda;
private import gda.ParameterList;
private import gda.Transaction;



private import gobject.ObjectG;

/**
 * Description
 *  This class is the main entry point for libgda client applications. It provides
 *  the way by which client applications open connections. Thus, before using any other
 *  database-oriented function in libgda, applications must create a GdaClient object
 *  (via gda_client_new), and, once created, open the connections from it.
 *  GdaClient also provides a way to treat several connections as if they were only
 *  one (a connection pool), which allows applications to, for instance, commit/rollback
 *  a transaction in all the connections being managed by a unique GdaClient object, or
 *  obtain the list of all tables in all opened connections.
 */
public class Client : ObjectG
{
	
	/** the main Gtk struct */
	protected GdaClient* gdaClient;
	
	
	public GdaClient* getClientStruct()
	{
		return gdaClient;
	}
	
	
	/** the main Gtk struct as a void* */
	protected override void* getStruct()
	{
		return cast(void*)gdaClient;
	}
	
	/**
	 * Sets our main struct and passes it to the parent class
	 */
	public this (GdaClient* gdaClient)
	{
		super(cast(GObject*)gdaClient);
		this.gdaClient = gdaClient;
	}
	
	protected override void setStruct(GObject* obj)
	{
		super.setStruct(obj);
		gdaClient = cast(GdaClient*)obj;
	}
	
	/**
	 * Establishes a connection to a data source. The connection will be opened
	 * if no identical connection is available in the GdaClient connection pool,
	 * and re-used if available. If you dont want to share the connection,
	 * specify GDA_CONNECTION_OPTIONS_DONT_SHARE as one of the flags in
	 * the options parameter.
	 * This function is the way of opening database connections with libgda.
	 * Params:
	 *  dsn = data source name.
	 *  username = user name.
	 *  password = password for username.
	 *  options = options for the connection (see GdaConnectionOptions).
	 * Returns :
	 *  the opened connection if successful, NULL if there is
	 *  an error.
	 */
	public Connection openConnection(string dsn, string username, string password, GdaConnectionOptions options)
	{
		// GdaConnection* gda_client_open_connection (GdaClient *client,  const gchar *dsn,  const gchar *username,  const gchar *password,  GdaConnectionOptions options);
		GdaConnection* connection = gda_client_open_connection(gdaClient, Str.toStringz(dsn), Str.toStringz(username), Str.toStringz(password), options);
		return connection ? new Connection( connection) : null;
	}
	
	/**
	 */
	
	/**
	 * Creates a new GdaClient object, which is the entry point for libgda
	 * client applications. This object, once created, can be used for
	 * opening new database connections and activating other services
	 * available to GDA clients.
	 * Throws: ConstructionException GTK+ fails to create the object.
	 */
	public this ()
	{
		// GdaClient* gda_client_new (void);
		auto p = gda_client_new();
		if(p is null)
		{
			throw new ConstructionException("null returned by gda_client_new()");
		}
		this(cast(GdaClient*) p);
	}
	
	/**
	 * Opens a connection given a provider ID and a connection string. This
	 * allows applications to open connections without having to create
	 * a data source in the configuration. The format of cnc_string is
	 * similar to PostgreSQL and MySQL connection strings. It is a ;-separated
	 * series of key=value pairs. Do not add extra whitespace after the ;
	 * separator. The possible keys depend on the provider, but
	 * Params:
	 * providerId = provider ID to connect to.
	 * cncString = connection string.
	 * options = options for the connection (see GdaConnectionOptions).
	 * Returns: the opened connection if successful, NULL if there is an error.
	 */
	public Connection openConnectionFromString(string providerId, string cncString, GdaConnectionOptions options)
	{
		// GdaConnection* gda_client_open_connection_from_string  (GdaClient *client,  const gchar *provider_id,  const gchar *cnc_string,  GdaConnectionOptions options);
		auto p = gda_client_open_connection_from_string(gdaClient, Str.toStringz(providerId), Str.toStringz(cncString), options);
		
		if(p is null)
		{
			return null;
		}
		
		return ObjectG.getDObject!(Connection)(cast(GdaConnection*) p);
	}
	
	/**
	 * Gets the list of all open connections in the given GdaClient object.
	 * The GList returned is an internal pointer, so DON'T TRY TO
	 * FREE IT.
	 * Returns: a GList of GdaConnection objects.
	 */
	public ListG getConnectionList()
	{
		// const GList* gda_client_get_connection_list (GdaClient *client);
		auto p = gda_client_get_connection_list(gdaClient);
		
		if(p is null)
		{
			return null;
		}
		
		return ObjectG.getDObject!(ListG)(cast(GList*) p);
	}
	
	/**
	 * Looks for an open connection given a data source name (per libgda
	 * configuration), a username and a password.
	 * This function iterates over the list of open connections in the
	 * given GdaClient and looks for one that matches the given data source
	 * name, username and password.
	 * Params:
	 * dsn = data source name.
	 * username = user name.
	 * password = password for username.
	 * Returns: a pointer to the found connection, or NULL if it could not be found.
	 */
	public Connection findConnection(string dsn, string username, string password)
	{
		// GdaConnection* gda_client_find_connection (GdaClient *client,  const gchar *dsn,  const gchar *username,  const gchar *password);
		auto p = gda_client_find_connection(gdaClient, Str.toStringz(dsn), Str.toStringz(username), Str.toStringz(password));
		
		if(p is null)
		{
			return null;
		}
		
		return ObjectG.getDObject!(Connection)(cast(GdaConnection*) p);
	}
	
	/**
	 * Closes all connections opened by the given GdaClient object.
	 */
	public void closeAllConnections()
	{
		// void gda_client_close_all_connections (GdaClient *client);
		gda_client_close_all_connections(gdaClient);
	}
	
	/**
	 * Notifies an event to the given GdaClient's listeners. The event can be
	 * anything (see GdaClientEvent) ranging from a connection opening
	 * operation, to changes made to a table in an underlying database.
	 * Params:
	 * cnc = a GdaConnection object where the event has occurred.
	 * event = event ID.
	 * params = parameters associated with the event.
	 */
	public void notifyEvent(Connection cnc, GdaClientEvent event, ParameterList params)
	{
		// void gda_client_notify_event (GdaClient *client,  GdaConnection *cnc,  GdaClientEvent event,  GdaParameterList *params);
		gda_client_notify_event(gdaClient, (cnc is null) ? null : cnc.getConnectionStruct(), event, (params is null) ? null : params.getParameterListStruct());
	}
	
	/**
	 * Notifies the given GdaClient of the GDA_CLIENT_EVENT_ERROR event.
	 * Params:
	 * cnc = a GdaConnection object.
	 * error = the error to be notified.
	 */
	public void notifyErrorEvent(Connection cnc, ErrorGda error)
	{
		// void gda_client_notify_error_event (GdaClient *client,  GdaConnection *cnc,  GdaError *error);
		gda_client_notify_error_event(gdaClient, (cnc is null) ? null : cnc.getConnectionStruct(), (error is null) ? null : error.getErrorGdaStruct());
	}
	
	/**
	 * Notifies the given GdaClient of the GDA_CLIENT_EVENT_CONNECTION_OPENED
	 * event.
	 * Params:
	 * cnc = a GdaConnection object.
	 */
	public void notifyConnectionOpenedEvent(Connection cnc)
	{
		// void gda_client_notify_connection_opened_event  (GdaClient *client,  GdaConnection *cnc);
		gda_client_notify_connection_opened_event(gdaClient, (cnc is null) ? null : cnc.getConnectionStruct());
	}
	
	/**
	 * Notifies the given GdaClient of the GDA_CLIENT_EVENT_CONNECTION_CLOSED
	 * event.
	 * Params:
	 * cnc = a GdaConnection object.
	 */
	public void notifyConnectionClosedEvent(Connection cnc)
	{
		// void gda_client_notify_connection_closed_event  (GdaClient *client,  GdaConnection *cnc);
		gda_client_notify_connection_closed_event(gdaClient, (cnc is null) ? null : cnc.getConnectionStruct());
	}
	
	/**
	 * Notifies the given GdaClient of the GDA_CLIENT_EVENT_TRANSACTION_STARTED
	 * event.
	 * Params:
	 * cnc = a GdaConnection object.
	 * xaction = a GdaTransaction object.
	 */
	public void notifyTransactionStartedEvent(Connection cnc, Transaction xaction)
	{
		// void gda_client_notify_transaction_started_event  (GdaClient *client,  GdaConnection *cnc,  GdaTransaction *xaction);
		gda_client_notify_transaction_started_event(gdaClient, (cnc is null) ? null : cnc.getConnectionStruct(), (xaction is null) ? null : xaction.getTransactionStruct());
	}
	
	/**
	 * Notifies the given GdaClient of the GDA_CLIENT_EVENT_TRANSACTION_COMMITTED
	 * event.
	 * Params:
	 * cnc = a GdaConnection object.
	 * xaction = a GdaTransaction object.
	 */
	public void notifyTransactionCommittedEvent(Connection cnc, Transaction xaction)
	{
		// void gda_client_notify_transaction_committed_event  (GdaClient *client,  GdaConnection *cnc,  GdaTransaction *xaction);
		gda_client_notify_transaction_committed_event(gdaClient, (cnc is null) ? null : cnc.getConnectionStruct(), (xaction is null) ? null : xaction.getTransactionStruct());
	}
	
	/**
	 * Notifies the given GdaClient of the GDA_CLIENT_EVENT_TRANSACTION_CANCELLED
	 * event.
	 * Params:
	 * cnc = a GdaConnection object.
	 * xaction = a GdaTransaction object.
	 */
	public void notifyTransactionCancelledEvent(Connection cnc, Transaction xaction)
	{
		// void gda_client_notify_transaction_cancelled_event  (GdaClient *client,  GdaConnection *cnc,  GdaTransaction *xaction);
		gda_client_notify_transaction_cancelled_event(gdaClient, (cnc is null) ? null : cnc.getConnectionStruct(), (xaction is null) ? null : xaction.getTransactionStruct());
	}
	
	/**
	 * Starts a transaction on all connections being managed by the given
	 * GdaClient. It is important to note that this operates on all
	 * connections opened within a GdaClient, which could not be what
	 * you're looking for.
	 * To execute a transaction on a unique connection, use
	 * gda_connection_begin_transaction, gda_connection_commit_transaction
	 * and gda_connection_rollback_transaction.
	 * Params:
	 * xaction = a GdaTransaction object.
	 * Returns: TRUE if all transactions could be started successfully, or FALSE if one of them fails.
	 */
	public int beginTransaction(Transaction xaction)
	{
		// gboolean gda_client_begin_transaction (GdaClient *client,  GdaTransaction *xaction);
		return gda_client_begin_transaction(gdaClient, (xaction is null) ? null : xaction.getTransactionStruct());
	}
	
	/**
	 * Commits a running transaction on all connections being managed by the given
	 * GdaClient. It is important to note that this operates on all
	 * connections opened within a GdaClient, which could not be what
	 * you're looking for.
	 * To execute a transaction on a unique connection, use
	 * gda_connection_begin_transaction, gda_connection_commit_transaction
	 * and gda_connection_rollback_transaction.
	 * Params:
	 * xaction = a GdaTransaction object.
	 * Returns: TRUE if all transactions could be committed successfully, or FALSE if one of them fails.
	 */
	public int commitTransaction(Transaction xaction)
	{
		// gboolean gda_client_commit_transaction (GdaClient *client,  GdaTransaction *xaction);
		return gda_client_commit_transaction(gdaClient, (xaction is null) ? null : xaction.getTransactionStruct());
	}
	
	/**
	 * Cancels a running transaction on all connections being managed by the given
	 * GdaClient. It is important to note that this operates on all
	 * connections opened within a GdaClient, which could not be what
	 * you're looking for.
	 * To execute a transaction on a unique connection, use
	 * gda_connection_begin_transaction, gda_connection_commit_transaction
	 * and gda_connection_rollback_transaction.
	 * Params:
	 * xaction = a GdaTransaction object.
	 * Returns: TRUE if all transactions could be cancelled successfully, or FALSE if one of them fails.
	 */
	public int rollbackTransaction(Transaction xaction)
	{
		// gboolean gda_client_rollback_transaction (GdaClient *client,  GdaTransaction *xaction);
		return gda_client_rollback_transaction(gdaClient, (xaction is null) ? null : xaction.getTransactionStruct());
	}
}