GdaXmlConnection

Name

GdaXmlConnection -- Management of connections to XML data sources

Synopsis



struct      GdaXmlConnectionPrivate;
GdaXmlConnection* gda_xml_connection_new    (void);
GdaXmlConnection* gda_xml_connection_new_from_file
                                            (const gchar *filename);
GdaXmlConnection* gda_xml_connection_new_from_string
                                            (const gchar *string);
gboolean    gda_xml_connection_set_from_file
                                            (GdaXmlConnection *xmlcnc,
                                             const gchar *filename);
gboolean    gda_xml_connection_set_from_string
                                            (GdaXmlConnection *xmlcnc,
                                             const gchar *string);
const gchar* gda_xml_connection_get_dsn     (GdaXmlConnection *xmlcnc);
void        gda_xml_connection_set_dsn      (GdaXmlConnection *xmlcnc,
                                             const gchar *dsn);
const gchar* gda_xml_connection_get_username
                                            (GdaXmlConnection *xmlcnc);
void        gda_xml_connection_set_username (GdaXmlConnection *xmlcnc,
                                             const gchar *username);
const gchar* gda_xml_connection_get_password
                                            (GdaXmlConnection *xmlcnc);
void        gda_xml_connection_set_password (GdaXmlConnection *xmlcnc,
                                             const gchar *password);

Description

Details

struct GdaXmlConnectionPrivate

struct GdaXmlConnectionPrivate;


gda_xml_connection_new ()

GdaXmlConnection* gda_xml_connection_new    (void);

Creates a new GdaXmlConnection object, which lets you parse and/or create .connection files, which are XML files used to specify all parameters needed to open a database connection, and which can be used to store user's connection preferences, or for automatic connection to databases from unattended scripts and such.

Returns :

the newly created object.


gda_xml_connection_new_from_file ()

GdaXmlConnection* gda_xml_connection_new_from_file
                                            (const gchar *filename);

Creates a GdaXmlConnection object from the contents of filename, which must be a correct .connection file.

filename :

name of file to create the GdaXmlConnection object from.

Returns :

the newly created object.


gda_xml_connection_new_from_string ()

GdaXmlConnection* gda_xml_connection_new_from_string
                                            (const gchar *string);

Creates a GdaXmlConnection object from the given XML string.

string :

XML string to create the GdaXmlConnection object from.

Returns :

the newly created object.


gda_xml_connection_set_from_file ()

gboolean    gda_xml_connection_set_from_file
                                            (GdaXmlConnection *xmlcnc,
                                             const gchar *filename);

Loads a XML file into the given GdaXmlConnection object.

xmlcnc :

a GdaXmlConnection object.

filename :

name of a XML file.

Returns :

TRUE if successful, FALSE otherwise.


gda_xml_connection_set_from_string ()

gboolean    gda_xml_connection_set_from_string
                                            (GdaXmlConnection *xmlcnc,
                                             const gchar *string);

Loads a XML string into the given GdaXmlConnection object.

xmlcnc :

a GdaXmlConnection object.

string :

XML connection file contents.

Returns :

TRUE if successful, FALSE otherwise.


gda_xml_connection_get_dsn ()

const gchar* gda_xml_connection_get_dsn     (GdaXmlConnection *xmlcnc);

xmlcnc :

a GdaXmlConnection object.

Returns :

the data source name for the given GdaXmlConnection object.


gda_xml_connection_set_dsn ()

void        gda_xml_connection_set_dsn      (GdaXmlConnection *xmlcnc,
                                             const gchar *dsn);

Sets the data source name for the given GdaXmlConnection object.

xmlcnc :

a GdaXmlConnection object.

dsn :

data source name.


gda_xml_connection_get_username ()

const gchar* gda_xml_connection_get_username
                                            (GdaXmlConnection *xmlcnc);

xmlcnc :

a GdaXmlConnection object.

Returns :

the user name defined in the GdaXmlConnection object.


gda_xml_connection_set_username ()

void        gda_xml_connection_set_username (GdaXmlConnection *xmlcnc,
                                             const gchar *username);

Sets the user name for the given GdaXmlConnection object.

xmlcnc :

a GdaXmlConnection object.

username :

new user name.


gda_xml_connection_get_password ()

const gchar* gda_xml_connection_get_password
                                            (GdaXmlConnection *xmlcnc);

xmlcnc :

a GdaXmlConnection object.

Returns :

the password defined in the GdaXmlConnection object.


gda_xml_connection_set_password ()

void        gda_xml_connection_set_password (GdaXmlConnection *xmlcnc,
                                             const gchar *password);

Sets the password for the given GdaXmlConnection object.

xmlcnc :

a GdaXmlConnection object.

password :

new password.