src/browseldap.c

   1 /*
   2  * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
   3  * Copyright (C) 2003-2012 Match Grun and the Claws Mail team
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 3 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program. If not, see <http://www.gnu.org/licenses/>.
  17  *
  18  */
  19
  20 /*
  21  * Browse LDAP entry.
  22  */
  23
  24 #ifdef HAVE_CONFIG_H
  25 #  include "config.h"
  26 #include "claws-features.h"
  27 #endif
  28
  29 #ifdef USE_LDAP
  30
  31 #include "defs.h"
  32
  33 #include <glib.h>
  34 #include <glib/gi18n.h>
  35 #include <gdk/gdkkeysyms.h>
  36 #include <gtk/gtk.h>
  37
  38 #include <pthread.h>
  39 #include "gtkutils.h"
  40 #include "stock_pixmap.h"
  41 #include "prefs_common.h"
  42 #include "browseldap.h"
  43 #include "addritem.h"
  44 #include "addrindex.h"
  45 #include "manage_window.h"
  46
  47 #include "ldapquery.h"
  48 #include "ldapserver.h"
  49 #include "ldaplocate.h"
  50
  51 typedef enum {
  52         COL_NAME  = 0,
  53         COL_VALUE = 1
  54 } LDAPEntryColumnPos;
  55
  56 #define BROWSELDAP_WIDTH    450
  57 #define BROWSELDAP_HEIGHT   420
  58
  59 #define N_COLS              2
  60 #define COL_WIDTH_NAME      140
  61 #define COL_WIDTH_VALUE     140
  62
  63 static struct _LDAPEntry_dlg {
  64         GtkWidget *window;
  65         GtkWidget *label_server;
  66         GtkWidget *label_address;
  67         GtkWidget *list_entry;
  68         GtkWidget *close_btn;
  69 } browseldap_dlg;
  70
  71 /**
  72  * Message queue.
  73  */
  74 static GList *_displayQueue_ = NULL;
  75
  76 /**
  77  * Mutex to protect callback from multiple threads.
  78  */
  79 static pthread_mutex_t _browseMutex_ = PTHREAD_MUTEX_INITIALIZER;
  80
  81 /**
  82  * Current query ID.
  83  */
  84 static gint _queryID_ = 0;
  85
  86 /**
  87  * Completion idle ID.
  88  */
  89 static guint _browseIdleID_ = 0;
  90
  91 /**
  92  * Search complete indicator.
  93  */
  94 static gboolean _searchComplete_ = FALSE;
  95
  96 /**
  97  * Callback entry point for each LDAP entry processed. The background thread
  98  * (if any) appends the address list to the display queue.
  99  *
 100  * \param qry        LDAP query object.
 101  * \param queryID    Query ID of search request.
 102  * \param listEMail  List of zero of more email objects that met search
 103  *                   criteria.
 104  * \param data       User data.
 105  */
 106 static gint browse_callback_entry(
 107                 LdapQuery *qry, gint queryID, GList *listValues, gpointer data )
 108 {
 109         GList *node;
 110         NameValuePair *nvp;
 111
 112         debug_print("browse_callback_entry...\n");
 113         pthread_mutex_lock( & _browseMutex_ );
 114         /* Append contents to end of display queue */
 115         node = listValues;
 116         while( node ) {
 117                 nvp = ( NameValuePair * ) node->data;
 118                 debug_print("adding to list: %s->%s\n",
 119                                 nvp->name?nvp->name:"null",
 120                                 nvp->value?nvp->value:"null");
 121                 _displayQueue_ = g_list_append( _displayQueue_, nvp );
 122                 node->data = NULL;
 123                 node = g_list_next( node );
 124         }
 125         pthread_mutex_unlock( & _browseMutex_ );
 126         /* g_print( "browse_callback_entry...done\n" ); */
 127
 128         return 0;
 129 }
 130
 131 /**
 132  * Callback entry point for end of LDAP locate search.
 133  *
 134  * \param qry     LDAP query object.
 135  * \param queryID Query ID of search request.
 136  * \param status  Status/error code.
 137  * \param data    User data.
 138  */
 139 static gint browse_callback_end(
 140                 LdapQuery *qry, gint queryID, gint status, gpointer data )
 141 {
 142         debug_print("search completed\n");
 143         _searchComplete_ = TRUE;
 144         return 0;
 145 }
 146
 147 /**
 148  * Clear the display queue.
 149  */
 150 static void browse_clear_queue( void ) {
 151         /* Clear out display queue */
 152         pthread_mutex_lock( & _browseMutex_ );
 153
 154         ldapqry_free_list_name_value( _displayQueue_ );
 155         g_list_free( _displayQueue_ );
 156         _displayQueue_ = NULL;
 157
 158         pthread_mutex_unlock( & _browseMutex_ );
 159 }
 160
 161 /**
 162  * Close window callback.
 163  * \param widget    Widget.
 164  * \param event     Event.
 165  * \param cancelled Cancelled flag.
 166  */
 167 static gint browse_delete_event(
 168                 GtkWidget *widget, GdkEventAny *event, gboolean *cancelled )
 169 {
 170         gtk_main_quit();
 171         return TRUE;
 172 }
 173
 174 /**
 175  * Respond to key press in window.
 176  * \param widget    Widget.
 177  * \param event     Event.
 178  * \param cancelled Cancelled flag.
 179  */
 180 static void browse_key_pressed(
 181                 GtkWidget *widget, GdkEventKey *event, gboolean *cancelled )
 182 {
 183         if (event && event->keyval == GDK_KEY_Escape) {
 184                 gtk_main_quit();
 185         }
 186 }
 187
 188 /**
 189  * Callback to close window.
 190  * \param widget    Widget.
 191  * \param cancelled Cancelled flag.
 192  */
 193 static void browse_close( GtkWidget *widget, gboolean *cancelled ) {
 194         gtk_main_quit();
 195 }
 196
 197 /**
 198  * Create the window to display data.
 199  */
 200 static void browse_create( void ) {
 201         GtkWidget *window;
 202         GtkWidget *vbox;
 203         GtkWidget *table;
 204         GtkWidget *label;
 205         GtkWidget *label_server;
 206         GtkWidget *label_addr;
 207         GtkWidget *list_entry;
 208         GtkWidget *vlbox;
 209         GtkWidget *tree_win;
 210         GtkWidget *hbbox;
 211         GtkWidget *close_btn;
 212         GtkWidget *content_area;
 213         gint top;
 214
 215         debug_print("creating browse widget\n");
 216         window = gtk_dialog_new();
 217         gtk_widget_set_size_request( window, BROWSELDAP_WIDTH, BROWSELDAP_HEIGHT );
 218         gtk_container_set_border_width( GTK_CONTAINER(window), 0 );
 219         gtk_window_set_title( GTK_WINDOW(window), _("Browse Directory Entry") );
 220         gtk_window_set_position( GTK_WINDOW(window), GTK_WIN_POS_MOUSE );
 221         g_signal_connect(G_OBJECT(window), "delete_event",
 222                          G_CALLBACK(browse_delete_event), NULL);
 223         g_signal_connect(G_OBJECT(window), "key_press_event",
 224                          G_CALLBACK(browse_key_pressed), NULL);
 225
 226         vbox = gtk_vbox_new(FALSE, 8);
 227         content_area = gtk_dialog_get_content_area(GTK_DIALOG(window));
 228         gtk_box_pack_start(GTK_BOX(content_area), vbox, TRUE, TRUE, 0);
 229         gtk_container_set_border_width( GTK_CONTAINER(vbox), 8 );
 230
 231         table = gtk_table_new(2, 2, FALSE);
 232         gtk_box_pack_start(GTK_BOX(vbox), table, FALSE, FALSE, 0);
 233         gtk_container_set_border_width( GTK_CONTAINER(table), 8 );
 234         gtk_table_set_row_spacings(GTK_TABLE(table), 8);
 235         gtk_table_set_col_spacings(GTK_TABLE(table), 8);
 236
 237         /* First row */
 238         top = 0;
 239         label = gtk_label_new(_("Server Name:"));
 240         gtk_table_attach(GTK_TABLE(table), label, 0, 1, top, (top + 1), GTK_FILL, 0, 0, 0);
 241         gtk_misc_set_alignment(GTK_MISC(label), 1, 0.5);
 242
 243         label_server = gtk_label_new("");
 244         gtk_table_attach(GTK_TABLE(table), label_server, 1, 2, top, (top + 1), GTK_FILL, 0, 0, 0);
 245         gtk_misc_set_alignment(GTK_MISC(label_server), 0, 0.5);
 246
 247         /* Second row */
 248         top++;
 249         label = gtk_label_new(_("Distinguished Name (dn):"));
 250         gtk_table_attach(GTK_TABLE(table), label, 0, 1, top, (top + 1), GTK_FILL, 0, 0, 0);
 251         gtk_misc_set_alignment(GTK_MISC(label), 1, 0.5);
 252
 253         label_addr = gtk_label_new("");
 254         gtk_table_attach(GTK_TABLE(table), label_addr, 1, 2, top, (top + 1), GTK_FILL, 0, 0, 0);
 255         gtk_misc_set_alignment(GTK_MISC(label_addr), 0, 0.5);
 256
 257         /* Address book/folder tree */
 258         vlbox = gtk_vbox_new(FALSE, 8);
 259         gtk_box_pack_start(GTK_BOX(vbox), vlbox, TRUE, TRUE, 0);
 260         gtk_container_set_border_width( GTK_CONTAINER(vlbox), 8 );
 261
 262         tree_win = gtk_scrolled_window_new( NULL, NULL );
 263         gtk_scrolled_window_set_policy( GTK_SCROLLED_WINDOW(tree_win),
 264                                         GTK_POLICY_AUTOMATIC,
 265                                         GTK_POLICY_AUTOMATIC );
 266         gtk_box_pack_start( GTK_BOX(vlbox), tree_win, TRUE, TRUE, 0 );
 267
 268         list_entry = gtk_cmclist_new( N_COLS );
 269         gtk_container_add( GTK_CONTAINER(tree_win), list_entry );
 270         gtk_cmclist_column_titles_show( GTK_CMCLIST(list_entry) );
 271         gtk_cmclist_set_column_title(
 272                 GTK_CMCLIST(list_entry), COL_NAME, _( "LDAP Name" ) );
 273         gtk_cmclist_set_column_title(
 274                 GTK_CMCLIST(list_entry), COL_VALUE, _( "Attribute Value" ) );
 275         gtk_cmclist_set_selection_mode(
 276                 GTK_CMCLIST(list_entry), GTK_SELECTION_BROWSE );
 277         gtk_cmclist_set_column_width( GTK_CMCLIST(list_entry),
 278                 COL_NAME, COL_WIDTH_NAME );
 279         gtk_cmclist_set_auto_sort( GTK_CMCLIST(list_entry), TRUE );
 280
 281         /* Button panel */
 282         gtkut_stock_button_set_create(&hbbox, &close_btn, GTK_STOCK_CLOSE,
 283                                       NULL, NULL, NULL, NULL);
 284         gtk_box_pack_end(GTK_BOX(vbox), hbbox, FALSE, FALSE, 0);
 285         gtk_container_set_border_width( GTK_CONTAINER(hbbox), 0 );
 286
 287         g_signal_connect(G_OBJECT(close_btn), "clicked",
 288                          G_CALLBACK(browse_close), NULL);
 289         gtk_widget_grab_default(close_btn);
 290
 291         gtk_widget_show_all(vbox);
 292
 293         browseldap_dlg.window        = window;
 294         browseldap_dlg.label_server  = label_server;
 295         browseldap_dlg.label_address = label_addr;
 296         browseldap_dlg.list_entry    = list_entry;
 297         browseldap_dlg.close_btn     = close_btn;
 298
 299         gtk_widget_show_all( window );
 300
 301 }
 302
 303 /**
 304  * Idler function. This function is called by the main (UI) thread during UI
 305  * idle time while an address search is in progress. Items from the display
 306  * queue are processed and appended to the address list.
 307  *
 308  * \param data Target data object.
 309  * \return <i>TRUE</i> to ensure that idle event do not get ignored.
 310  */
 311 static gboolean browse_idle( gpointer data ) {
 312         GList *node;
 313         NameValuePair *nvp;
 314         gchar *text[N_COLS];
 315
 316         /* Process all entries in display queue */
 317         pthread_mutex_lock( & _browseMutex_ );
 318         if( _displayQueue_ ) {
 319                 node = _displayQueue_;
 320                 while( node ) {
 321                         /* Add entry into list */
 322                         nvp = ( NameValuePair * ) node->data;
 323                         text[COL_NAME]  = nvp->name;
 324                         text[COL_VALUE] = nvp->value;
 325                         debug_print("Adding row to list: %s->%s\n",
 326                                                 nvp->name?nvp->name:"null",
 327                                                 nvp->value?nvp->value:"null");
 328                         gtk_cmclist_append(
 329                                 GTK_CMCLIST(browseldap_dlg.list_entry), text );
 330
 331                         /* Free up entry */
 332                         ldapqry_free_name_value( nvp );
 333                         node->data = NULL;
 334                         node = g_list_next( node );
 335                 }
 336                 g_list_free( _displayQueue_ );
 337                 _displayQueue_ = NULL;
 338         }
 339         pthread_mutex_unlock( & _browseMutex_ );
 340
 341         if( _searchComplete_ ) {
 342                 /* Remove idler */
 343                 if( _browseIdleID_ != 0 ) {
 344                         g_source_remove( _browseIdleID_ );
 345                         _browseIdleID_ = 0;
 346                         gtk_cmclist_select_row(
 347                                 GTK_CMCLIST( browseldap_dlg.list_entry ), 0, 0 );
 348                 }
 349         }
 350
 351         return TRUE;
 352 }
 353
 354 /**
 355  * Main entry point to browse LDAP entries.
 356  * \param  ds Data source to process.
 357  * \param  dn Distinguished name to retrieve.
 358  * \return <code>TRUE</code>
 359  */
 360 gboolean browseldap_entry( AddressDataSource *ds, const gchar *dn ) {
 361         LdapServer *server;
 362
 363         _queryID_ = 0;
 364         _browseIdleID_ = 0;
 365
 366         server = ds->rawDataSource;
 367
 368         if( ! browseldap_dlg.window ) browse_create();
 369         gtk_widget_grab_focus(browseldap_dlg.close_btn);
 370         gtk_widget_show(browseldap_dlg.window);
 371         manage_window_set_transient(GTK_WINDOW(browseldap_dlg.window));
 372         gtk_window_set_modal(GTK_WINDOW(browseldap_dlg.window), TRUE);
 373         gtk_cmclist_select_row( GTK_CMCLIST( browseldap_dlg.list_entry ), 0, 0 );
 374         gtk_widget_show(browseldap_dlg.window);
 375
 376         gtk_label_set_text( GTK_LABEL(browseldap_dlg.label_address ), "" );
 377         if( dn ) {
 378                 gtk_label_set_text(
 379                         GTK_LABEL(browseldap_dlg.label_address ), dn );
 380         }
 381         gtk_label_set_text(
 382                 GTK_LABEL(browseldap_dlg.label_server ),
 383                 ldapsvr_get_name( server ) );
 384
 385         debug_print("browsing server: %s\n", ldapsvr_get_name(server));
 386         /* Setup search */
 387         _searchComplete_ = FALSE;
 388         _queryID_ = ldaplocate_search_setup(
 389                         server, dn, browse_callback_entry, browse_callback_end );
 390         debug_print("query id: %d\n", _queryID_);
 391         _browseIdleID_ = g_idle_add( (GSourceFunc) browse_idle, NULL );
 392
 393         /* Start search */
 394         debug_print("starting search\n");
 395         ldaplocate_search_start( _queryID_ );
 396
 397         /* Display dialog */
 398         gtk_main();
 399         gtk_widget_hide( browseldap_dlg.window );
 400         gtk_window_set_modal(GTK_WINDOW(browseldap_dlg.window), FALSE);
 401         /* Stop query */
 402         debug_print("stopping search\n");
 403         ldaplocate_search_stop( _queryID_ );
 404
 405         if( _browseIdleID_ != 0 ) {
 406                 g_source_remove( _browseIdleID_ );
 407                 _browseIdleID_ = 0;
 408         }
 409         browse_clear_queue();
 410         gtk_cmclist_clear( GTK_CMCLIST( browseldap_dlg.list_entry ) );
 411
 412         return TRUE;
 413 }
 414
 415 #endif /* USE_LDAP */
 416
 417 /*
 418 * End of Source.
 419 */
 420