src/client.c

   1 /* This file is part of Pazpar2.
   2    Copyright (C) 2006-2011 Index Data
   3
   4 Pazpar2 is free software; you can redistribute it and/or modify it under
   5 the terms of the GNU General Public License as published by the Free
   6 Software Foundation; either version 2, or (at your option) any later
   7 version.
   8
   9 Pazpar2 is distributed in the hope that it will be useful, but WITHOUT ANY
  10 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12 for more details.
  13
  14 You should have received a copy of the GNU General Public License
  15 along with this program; if not, write to the Free Software
  16 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  17
  18 */
  19
  20 /** \file client.c
  21     \brief Z39.50 client
  22 */
  23
  24 #if HAVE_CONFIG_H
  25 #include <config.h>
  26 #endif
  27 #include <stdlib.h>
  28 #include <stdio.h>
  29 #include <string.h>
  30 #if HAVE_SYS_TIME_H
  31 #include <sys/time.h>
  32 #endif
  33 #if HAVE_UNISTD_H
  34 #include <unistd.h>
  35 #endif
  36 #include <signal.h>
  37 #include <assert.h>
  38
  39 #include <yaz/marcdisp.h>
  40 #include <yaz/comstack.h>
  41 #include <yaz/tcpip.h>
  42 #include <yaz/proto.h>
  43 #include <yaz/readconf.h>
  44 #include <yaz/pquery.h>
  45 #include <yaz/otherinfo.h>
  46 #include <yaz/yaz-util.h>
  47 #include <yaz/nmem.h>
  48 #include <yaz/query-charset.h>
  49 #include <yaz/querytowrbuf.h>
  50 #include <yaz/oid_db.h>
  51 #include <yaz/diagbib1.h>
  52 #include <yaz/snprintf.h>
  53 #include <yaz/rpn2cql.h>
  54 #include <yaz/rpn2solr.h>
  55
  56 #define USE_TIMING 0
  57 #if USE_TIMING
  58 #include <yaz/timing.h>
  59 #endif
  60
  61 #include "ppmutex.h"
  62 #include "session.h"
  63 #include "parameters.h"
  64 #include "client.h"
  65 #include "connection.h"
  66 #include "settings.h"
  67 #include "relevance.h"
  68 #include "incref.h"
  69
  70 static YAZ_MUTEX g_mutex = 0;
  71 static int no_clients = 0;
  72 static int no_clients_total = 0;
  73
  74 static int client_use(int delta)
  75 {
  76     int clients;
  77     if (!g_mutex)
  78         yaz_mutex_create(&g_mutex);
  79     yaz_mutex_enter(g_mutex);
  80     no_clients += delta;
  81     if (delta > 0)
  82         no_clients_total += delta;
  83     clients = no_clients;
  84     yaz_mutex_leave(g_mutex);
  85     yaz_log(YLOG_DEBUG, "%s clients=%d", delta == 0 ? "" : (delta > 0 ? "INC" : "DEC"), clients);
  86     return clients;
  87 }
  88
  89 int  clients_count(void) {
  90     return client_use(0);
  91 }
  92
  93 int  clients_count_total(void) {
  94     int total = 0;
  95     if (!g_mutex)
  96         return 0;
  97     yaz_mutex_enter(g_mutex);
  98     total = no_clients_total;
  99     yaz_mutex_leave(g_mutex);
 100     return total;
 101 }
 102
 103
 104 /** \brief Represents client state for a connection to one search target */
 105 struct client {
 106     struct session_database *database;
 107     struct connection *connection;
 108     struct session *session;
 109     char *pquery; // Current search
 110     char *cqlquery; // used for SRU targets only
 111     Odr_int hits;
 112     int record_offset;
 113     int maxrecs;
 114     int startrecs;
 115     int diagnostic;
 116     int preferred;
 117     enum client_state state;
 118     struct show_raw *show_raw;
 119     ZOOM_resultset resultset;
 120     YAZ_MUTEX mutex;
 121     int ref_count;
 122     /* copy of database->url */
 123     char *url;
 124 };
 125
 126 struct show_raw {
 127     int active; // whether this request has been sent to the server
 128     int position;
 129     int binary;
 130     char *syntax;
 131     char *esn;
 132     void (*error_handler)(void *data, const char *addinfo);
 133     void (*record_handler)(void *data, const char *buf, size_t sz);
 134     void *data;
 135     struct show_raw *next;
 136 };
 137
 138 static const char *client_states[] = {
 139     "Client_Connecting",
 140     "Client_Idle",
 141     "Client_Working",
 142     "Client_Error",
 143     "Client_Failed",
 144     "Client_Disconnected"
 145 };
 146
 147 const char *client_get_state_str(struct client *cl)
 148 {
 149     return client_states[cl->state];
 150 }
 151
 152 enum client_state client_get_state(struct client *cl)
 153 {
 154     return cl->state;
 155 }
 156
 157 void client_set_state(struct client *cl, enum client_state st)
 158 {
 159     int was_active = 0;
 160     if (client_is_active(cl))
 161         was_active = 1;
 162     cl->state = st;
 163     /* If client is going from being active to inactive and all clients
 164        are now idle we fire a watch for the session . The assumption is
 165        that session is not mutex locked if client is already active */
 166     if (was_active && !client_is_active(cl) && cl->session)
 167     {
 168
 169         int no_active = session_active_clients(cl->session);
 170         yaz_log(YLOG_DEBUG, "%s: releasing watches on zero active: %d", client_get_url(cl), no_active);
 171         if (no_active == 0) {
 172             session_alert_watch(cl->session, SESSION_WATCH_SHOW);
 173             session_alert_watch(cl->session, SESSION_WATCH_SHOW_PREF);
 174         }
 175     }
 176 }
 177
 178 static void client_show_raw_error(struct client *cl, const char *addinfo);
 179
 180 struct connection *client_get_connection(struct client *cl)
 181 {
 182     return cl->connection;
 183 }
 184
 185 struct session_database *client_get_database(struct client *cl)
 186 {
 187     return cl->database;
 188 }
 189
 190 struct session *client_get_session(struct client *cl)
 191 {
 192     return cl->session;
 193 }
 194
 195 const char *client_get_pquery(struct client *cl)
 196 {
 197     return cl->pquery;
 198 }
 199
 200 static void client_send_raw_present(struct client *cl);
 201 static int nativesyntax_to_type(struct session_database *sdb, char *type,
 202                                 ZOOM_record rec);
 203
 204 static void client_show_immediate(
 205     ZOOM_resultset resultset, struct session_database *sdb, int position,
 206     void *data,
 207     void (*error_handler)(void *data, const char *addinfo),
 208     void (*record_handler)(void *data, const char *buf, size_t sz),
 209     int binary)
 210 {
 211     ZOOM_record rec = 0;
 212     char type[80];
 213     const char *buf;
 214     int len;
 215
 216     if (!resultset)
 217     {
 218         error_handler(data, "no resultset");
 219         return;
 220     }
 221     rec = ZOOM_resultset_record(resultset, position-1);
 222     if (!rec)
 223     {
 224         error_handler(data, "no record");
 225         return;
 226     }
 227     if (binary)
 228         strcpy(type, "raw");
 229     else
 230         nativesyntax_to_type(sdb, type, rec);
 231     buf = ZOOM_record_get(rec, type, &len);
 232     if (!buf)
 233     {
 234         error_handler(data, "no record");
 235         return;
 236     }
 237     record_handler(data, buf, len);
 238 }
 239
 240
 241 int client_show_raw_begin(struct client *cl, int position,
 242                           const char *syntax, const char *esn,
 243                           void *data,
 244                           void (*error_handler)(void *data, const char *addinfo),
 245                           void (*record_handler)(void *data, const char *buf,
 246                                                  size_t sz),
 247                           int binary)
 248 {
 249     if (syntax == 0 && esn == 0)
 250         client_show_immediate(cl->resultset, client_get_database(cl),
 251                               position, data,
 252                               error_handler, record_handler,
 253                               binary);
 254     else
 255     {
 256         struct show_raw *rr, **rrp;
 257
 258         if (!cl->connection)
 259             return -1;
 260
 261
 262         rr = xmalloc(sizeof(*rr));
 263         rr->position = position;
 264         rr->active = 0;
 265         rr->data = data;
 266         rr->error_handler = error_handler;
 267         rr->record_handler = record_handler;
 268         rr->binary = binary;
 269         if (syntax)
 270             rr->syntax = xstrdup(syntax);
 271         else
 272             rr->syntax = 0;
 273         if (esn)
 274             rr->esn = xstrdup(esn);
 275         else
 276             rr->esn = 0;
 277         rr->next = 0;
 278
 279         for (rrp = &cl->show_raw; *rrp; rrp = &(*rrp)->next)
 280             ;
 281         *rrp = rr;
 282
 283         if (cl->state == Client_Failed)
 284         {
 285             client_show_raw_error(cl, "client failed");
 286         }
 287         else if (cl->state == Client_Disconnected)
 288         {
 289             client_show_raw_error(cl, "client disconnected");
 290         }
 291         else
 292         {
 293             client_send_raw_present(cl);
 294         }
 295     }
 296     return 0;
 297 }
 298
 299 static void client_show_raw_delete(struct show_raw *r)
 300 {
 301     xfree(r->syntax);
 302     xfree(r->esn);
 303     xfree(r);
 304 }
 305
 306 void client_show_raw_remove(struct client *cl, void *data)
 307 {
 308     struct show_raw *rr = data;
 309     struct show_raw **rrp = &cl->show_raw;
 310     while (*rrp != rr)
 311         rrp = &(*rrp)->next;
 312     if (*rrp)
 313     {
 314         *rrp = rr->next;
 315         client_show_raw_delete(rr);
 316     }
 317 }
 318
 319 void client_show_raw_dequeue(struct client *cl)
 320 {
 321     struct show_raw *rr = cl->show_raw;
 322
 323     cl->show_raw = rr->next;
 324     client_show_raw_delete(rr);
 325 }
 326
 327 static void client_show_raw_error(struct client *cl, const char *addinfo)
 328 {
 329     while (cl->show_raw)
 330     {
 331         cl->show_raw->error_handler(cl->show_raw->data, addinfo);
 332         client_show_raw_dequeue(cl);
 333     }
 334 }
 335
 336 static void client_send_raw_present(struct client *cl)
 337 {
 338     struct session_database *sdb = client_get_database(cl);
 339     struct connection *co = client_get_connection(cl);
 340     ZOOM_resultset set = cl->resultset;
 341
 342     int offset = cl->show_raw->position;
 343     const char *syntax = 0;
 344     const char *elements = 0;
 345
 346     assert(cl->show_raw);
 347     assert(set);
 348
 349     yaz_log(YLOG_DEBUG, "%s: trying to present %d record(s) from %d",
 350             client_get_url(cl), 1, offset);
 351
 352     if (cl->show_raw->syntax)
 353         syntax = cl->show_raw->syntax;
 354     else
 355         syntax = session_setting_oneval(sdb, PZ_REQUESTSYNTAX);
 356     ZOOM_resultset_option_set(set, "preferredRecordSyntax", syntax);
 357
 358     if (cl->show_raw->esn)
 359         elements = cl->show_raw->esn;
 360     else
 361         elements = session_setting_oneval(sdb, PZ_ELEMENTS);
 362     if (elements && *elements)
 363         ZOOM_resultset_option_set(set, "elementSetName", elements);
 364
 365     ZOOM_resultset_records(set, 0, offset-1, 1);
 366     cl->show_raw->active = 1;
 367
 368     connection_continue(co);
 369 }
 370
 371 static int nativesyntax_to_type(struct session_database *sdb, char *type,
 372                                 ZOOM_record rec)
 373 {
 374     const char *s = session_setting_oneval(sdb, PZ_NATIVESYNTAX);
 375
 376     if (s && *s)
 377     {
 378         if (!strncmp(s, "iso2709", 7))
 379         {
 380             const char *cp = strchr(s, ';');
 381             yaz_snprintf(type, 80, "xml; charset=%s", cp ? cp+1 : "marc-8s");
 382         }
 383         else if (!strncmp(s, "xml", 3))
 384         {
 385             strcpy(type, "xml");
 386         }
 387         else if (!strncmp(s, "txml", 4))
 388         {
 389             const char *cp = strchr(s, ';');
 390             yaz_snprintf(type, 80, "txml; charset=%s", cp ? cp+1 : "marc-8s");
 391         }
 392         else
 393             return -1;
 394         return 0;
 395     }
 396     else  /* attempt to deduce structure */
 397     {
 398         const char *syntax = ZOOM_record_get(rec, "syntax", NULL);
 399         if (syntax)
 400         {
 401             if (!strcmp(syntax, "XML"))
 402             {
 403                 strcpy(type, "xml");
 404                 return 0;
 405             }
 406             else if (!strcmp(syntax, "TXML"))
 407                 {
 408                     strcpy(type, "txml");
 409                     return 0;
 410                 }
 411             else if (!strcmp(syntax, "USmarc") || !strcmp(syntax, "MARC21"))
 412             {
 413                 strcpy(type, "xml; charset=marc8-s");
 414                 return 0;
 415             }
 416             else return -1;
 417         }
 418         else return -1;
 419     }
 420 }
 421
 422 /**
 423  * TODO Consider thread safety!!!
 424  *
 425  */
 426 int client_report_facets(struct client *cl, ZOOM_resultset rs) {
 427     int facet_idx;
 428     ZOOM_facet_field *facets = ZOOM_resultset_facets(rs);
 429     int facet_num;
 430     struct session *se = client_get_session(cl);
 431     facet_num = ZOOM_resultset_facets_size(rs);
 432     yaz_log(YLOG_DEBUG, "client_report_facets: %d", facet_num);
 433
 434     for (facet_idx = 0; facet_idx < facet_num; facet_idx++) {
 435         const char *name = ZOOM_facet_field_name(facets[facet_idx]);
 436         size_t term_idx;
 437         size_t term_num = ZOOM_facet_field_term_count(facets[facet_idx]);
 438         for (term_idx = 0; term_idx < term_num; term_idx++ ) {
 439             int freq;
 440             const char *term = ZOOM_facet_field_get_term(facets[facet_idx], term_idx, &freq);
 441             if (term)
 442                 add_facet(se, name, term, freq);
 443         }
 444     }
 445
 446     return 0;
 447 }
 448
 449 static void ingest_raw_record(struct client *cl, ZOOM_record rec)
 450 {
 451     const char *buf;
 452     int len;
 453     char type[80];
 454
 455     if (cl->show_raw->binary)
 456         strcpy(type, "raw");
 457     else
 458     {
 459         struct session_database *sdb = client_get_database(cl);
 460         nativesyntax_to_type(sdb, type, rec);
 461     }
 462
 463     buf = ZOOM_record_get(rec, type, &len);
 464     cl->show_raw->record_handler(cl->show_raw->data,  buf, len);
 465     client_show_raw_dequeue(cl);
 466 }
 467
 468 void client_check_preferred_watch(struct client *cl)
 469 {
 470     struct session *se = cl->session;
 471     yaz_log(YLOG_DEBUG, "client_check_preferred_watch: %s ", client_get_url(cl));
 472     if (se)
 473     {
 474         client_unlock(cl);
 475         /* TODO possible threading issue. Session can have been destroyed */
 476         if (session_is_preferred_clients_ready(se)) {
 477             session_alert_watch(se, SESSION_WATCH_SHOW_PREF);
 478         }
 479         else
 480             yaz_log(YLOG_DEBUG, "client_check_preferred_watch: Still locked on preferred targets.");
 481
 482         client_lock(cl);
 483     }
 484     else
 485         yaz_log(YLOG_WARN, "client_check_preferred_watch: %s. No session!", client_get_url(cl));
 486
 487 }
 488
 489 void client_search_response(struct client *cl)
 490 {
 491     struct connection *co = cl->connection;
 492     struct session *se = cl->session;
 493     ZOOM_connection link = connection_get_link(co);
 494     ZOOM_resultset resultset = cl->resultset;
 495
 496     const char *error, *addinfo = 0;
 497
 498     if (ZOOM_connection_error(link, &error, &addinfo))
 499     {
 500         cl->hits = 0;
 501         client_set_state(cl, Client_Error);
 502         yaz_log(YLOG_WARN, "Search error %s (%s): %s",
 503                 error, addinfo, client_get_url(cl));
 504     }
 505     else
 506     {
 507         yaz_log(YLOG_DEBUG, "client_search_response: hits "
 508                 ODR_INT_PRINTF, cl->hits);
 509         client_report_facets(cl, resultset);
 510         cl->record_offset = cl->startrecs;
 511         cl->hits = ZOOM_resultset_size(resultset);
 512         if (se) {
 513             se->total_hits += cl->hits;
 514             yaz_log(YLOG_DEBUG, "client_search_response: total hits "
 515                     ODR_INT_PRINTF, se->total_hits);
 516         }
 517     }
 518 }
 519
 520 void client_got_records(struct client *cl)
 521 {
 522     struct session *se = cl->session;
 523     if (se)
 524     {
 525         client_unlock(cl);
 526         session_alert_watch(se, SESSION_WATCH_SHOW);
 527         session_alert_watch(se, SESSION_WATCH_RECORD);
 528         client_lock(cl);
 529     }
 530 }
 531
 532 void client_record_response(struct client *cl)
 533 {
 534     struct connection *co = cl->connection;
 535     ZOOM_connection link = connection_get_link(co);
 536     ZOOM_resultset resultset = cl->resultset;
 537     const char *error, *addinfo;
 538
 539     if (ZOOM_connection_error(link, &error, &addinfo))
 540     {
 541         client_set_state(cl, Client_Error);
 542         yaz_log(YLOG_WARN, "Search error %s (%s): %s",
 543             error, addinfo, client_get_url(cl));
 544     }
 545     else
 546     {
 547         ZOOM_record rec = 0;
 548         const char *msg, *addinfo;
 549
 550         if (cl->show_raw && cl->show_raw->active)
 551         {
 552             if ((rec = ZOOM_resultset_record(resultset,
 553                                              cl->show_raw->position-1)))
 554             {
 555                 cl->show_raw->active = 0;
 556                 ingest_raw_record(cl, rec);
 557             }
 558             else
 559             {
 560                 yaz_log(YLOG_WARN, "Expected record, but got NULL, offset=%d",
 561                         cl->show_raw->position-1);
 562             }
 563         }
 564         else
 565         {
 566             int offset = cl->record_offset;
 567             if ((rec = ZOOM_resultset_record(resultset, offset)))
 568             {
 569                 cl->record_offset++;
 570                 if (cl->session == 0)
 571                     ;
 572                 else if (ZOOM_record_error(rec, &msg, &addinfo, 0))
 573                 {
 574                     yaz_log(YLOG_WARN, "Record error %s (%s): %s (rec #%d)",
 575                             msg, addinfo, client_get_url(cl),
 576                             cl->record_offset);
 577                 }
 578                 else
 579                 {
 580                     struct session_database *sdb = client_get_database(cl);
 581                     NMEM nmem = nmem_create();
 582                     const char *xmlrec;
 583                     char type[80];
 584
 585                     if (nativesyntax_to_type(sdb, type, rec))
 586                         yaz_log(YLOG_WARN, "Failed to determine record type");
 587                     xmlrec = ZOOM_record_get(rec, type, NULL);
 588                     if (!xmlrec)
 589                         yaz_log(YLOG_WARN, "ZOOM_record_get failed from %s",
 590                                 client_get_url(cl));
 591                     else
 592                     {
 593                         /* OK = 0, -1 = failure, -2 = Filtered */
 594                         if (ingest_record(cl, xmlrec, cl->record_offset, nmem) == -1)
 595                             yaz_log(YLOG_WARN, "Failed to ingest from %s", client_get_url(cl));
 596                     }
 597                     nmem_destroy(nmem);
 598                 }
 599             }
 600             else
 601             {
 602                 yaz_log(YLOG_WARN, "Expected record, but got NULL, offset=%d",
 603                         offset);
 604             }
 605         }
 606     }
 607 }
 608
 609 static int client_set_facets_request(struct client *cl, ZOOM_connection link)
 610 {
 611     struct session_database *sdb = client_get_database(cl);
 612     const char *opt_facet_term_sort  = session_setting_oneval(sdb, PZ_TERMLIST_TERM_SORT);
 613     const char *opt_facet_term_count = session_setting_oneval(sdb, PZ_TERMLIST_TERM_COUNT);
 614
 615     /* Future record filtering on target */
 616     /* const char *opt_facet_record_filter = session_setting_oneval(sdb, PZ_RECORDFILTER); */
 617
 618     /* Disable when no count is set */
 619     /* TODO Verify: Do we need to reset the  ZOOM facets if a ZOOM Connection is being reused??? */
 620     if (opt_facet_term_count && *opt_facet_term_count)
 621     {
 622         int index = 0;
 623         struct session *session = client_get_session(cl);
 624         struct conf_service *service = session->service;
 625         int num = service->num_metadata;
 626         WRBUF wrbuf = wrbuf_alloc();
 627         yaz_log(YLOG_DEBUG, "Facet settings, sort: %s count: %s",
 628                 opt_facet_term_sort, opt_facet_term_count);
 629         for (index = 0; index < num; index++)
 630         {
 631             struct conf_metadata *conf_meta = &service->metadata[index];
 632             if (conf_meta->termlist)
 633             {
 634                 if (wrbuf_len(wrbuf))
 635                     wrbuf_puts(wrbuf, ", ");
 636                 wrbuf_printf(wrbuf, "@attr 1=%s", conf_meta->name);
 637
 638                 if (opt_facet_term_sort && *opt_facet_term_sort)
 639                     wrbuf_printf(wrbuf, " @attr 2=%s", opt_facet_term_sort);
 640                 wrbuf_printf(wrbuf, " @attr 3=%s", opt_facet_term_count);
 641             }
 642         }
 643         if (wrbuf_len(wrbuf))
 644         {
 645             yaz_log(YLOG_LOG, "Setting ZOOM facets option: %s", wrbuf_cstr(wrbuf));
 646             ZOOM_connection_option_set(link, "facets", wrbuf_cstr(wrbuf));
 647             return 1;
 648         }
 649     }
 650     return 0;
 651 }
 652
 653 int client_has_facet(struct client *cl, const char *name) {
 654     ZOOM_facet_field facet_field;
 655     if (!cl || !cl->resultset || !name) {
 656         return 0;
 657     }
 658     facet_field = ZOOM_resultset_get_facet_field(cl->resultset, name);
 659     if (facet_field) {
 660         return 1;
 661     }
 662     return 0;
 663 }
 664
 665
 666 void client_start_search(struct client *cl)
 667 {
 668     struct session_database *sdb = client_get_database(cl);
 669     struct connection *co = client_get_connection(cl);
 670     ZOOM_connection link = connection_get_link(co);
 671     ZOOM_resultset rs;
 672     char *databaseName = sdb->database->databases[0];
 673     const char *opt_piggyback   = session_setting_oneval(sdb, PZ_PIGGYBACK);
 674     const char *opt_queryenc    = session_setting_oneval(sdb, PZ_QUERYENCODING);
 675     const char *opt_elements    = session_setting_oneval(sdb, PZ_ELEMENTS);
 676     const char *opt_requestsyn  = session_setting_oneval(sdb, PZ_REQUESTSYNTAX);
 677     const char *opt_maxrecs     = session_setting_oneval(sdb, PZ_MAXRECS);
 678     const char *opt_sru         = session_setting_oneval(sdb, PZ_SRU);
 679     const char *opt_sort        = session_setting_oneval(sdb, PZ_SORT);
 680     const char *opt_preferred   = session_setting_oneval(sdb, PZ_PREFERRED);
 681     const char *extra_args      = session_setting_oneval(sdb, PZ_EXTRA_ARGS);
 682     char maxrecs_str[24], startrecs_str[24];
 683
 684     assert(link);
 685
 686     cl->hits = -1;
 687     cl->record_offset = 0;
 688     cl->diagnostic = 0;
 689
 690     if (extra_args && *extra_args)
 691         ZOOM_connection_option_set(link, "extraArgs", extra_args);
 692
 693     if (opt_preferred) {
 694         cl->preferred = atoi(opt_preferred);
 695         if (cl->preferred)
 696             yaz_log(YLOG_LOG, "Target %s has preferred status: %d", sdb->database->url, cl->preferred);
 697     }
 698     client_set_state(cl, Client_Working);
 699
 700     if (*opt_piggyback)
 701         ZOOM_connection_option_set(link, "piggyback", opt_piggyback);
 702     else
 703         ZOOM_connection_option_set(link, "piggyback", "1");
 704     if (*opt_queryenc)
 705         ZOOM_connection_option_set(link, "rpnCharset", opt_queryenc);
 706     if (*opt_sru && *opt_elements)
 707         ZOOM_connection_option_set(link, "schema", opt_elements);
 708     else if (*opt_elements)
 709         ZOOM_connection_option_set(link, "elementSetName", opt_elements);
 710     if (*opt_requestsyn)
 711         ZOOM_connection_option_set(link, "preferredRecordSyntax", opt_requestsyn);
 712
 713     if (opt_maxrecs && *opt_maxrecs)
 714     {
 715         cl->maxrecs = atoi(opt_maxrecs);
 716     }
 717
 718     /* convert back to string representation used in ZOOM API */
 719     sprintf(maxrecs_str, "%d", cl->maxrecs);
 720     ZOOM_connection_option_set(link, "count", maxrecs_str);
 721
 722     if (cl->maxrecs > 20)
 723         ZOOM_connection_option_set(link, "presentChunk", "20");
 724     else
 725         ZOOM_connection_option_set(link, "presentChunk", maxrecs_str);
 726
 727     sprintf(startrecs_str, "%d", cl->startrecs);
 728     ZOOM_connection_option_set(link, "start", startrecs_str);
 729
 730     if (databaseName)
 731         ZOOM_connection_option_set(link, "databaseName", databaseName);
 732
 733     /* TODO Verify does it break something for CQL targets(non-SOLR) ? */
 734     /* facets definition is in PQF */
 735     client_set_facets_request(cl, link);
 736
 737     if (cl->cqlquery)
 738     {
 739         ZOOM_query q = ZOOM_query_create();
 740         yaz_log(YLOG_LOG, "Search %s CQL: %s", sdb->database->url, cl->cqlquery);
 741         ZOOM_query_cql(q, cl->cqlquery);
 742         if (*opt_sort)
 743             ZOOM_query_sortby(q, opt_sort);
 744         rs = ZOOM_connection_search(link, q);
 745         ZOOM_query_destroy(q);
 746     }
 747     else
 748     {
 749         yaz_log(YLOG_LOG, "Search %s PQF: %s", sdb->database->url, cl->pquery);
 750         rs = ZOOM_connection_search_pqf(link, cl->pquery);
 751     }
 752     ZOOM_resultset_destroy(cl->resultset);
 753     cl->resultset = rs;
 754     connection_continue(co);
 755 }
 756
 757 struct client *client_create(void)
 758 {
 759     struct client *cl = xmalloc(sizeof(*cl));
 760     cl->maxrecs = 100;
 761     cl->startrecs = 0;
 762     cl->pquery = 0;
 763     cl->cqlquery = 0;
 764     cl->database = 0;
 765     cl->connection = 0;
 766     cl->session = 0;
 767     cl->hits = 0;
 768     cl->record_offset = 0;
 769     cl->diagnostic = 0;
 770     cl->state = Client_Disconnected;
 771     cl->show_raw = 0;
 772     cl->resultset = 0;
 773     cl->mutex = 0;
 774     pazpar2_mutex_create(&cl->mutex, "client");
 775     cl->preferred = 0;
 776     cl->ref_count = 1;
 777     cl->url = 0;
 778     client_use(1);
 779
 780     return cl;
 781 }
 782
 783 void client_lock(struct client *c)
 784 {
 785     yaz_mutex_enter(c->mutex);
 786 }
 787
 788 void client_unlock(struct client *c)
 789 {
 790     yaz_mutex_leave(c->mutex);
 791 }
 792
 793 void client_incref(struct client *c)
 794 {
 795     pazpar2_incref(&c->ref_count, c->mutex);
 796     yaz_log(YLOG_DEBUG, "client_incref c=%p %s cnt=%d",
 797             c, client_get_url(c), c->ref_count);
 798 }
 799
 800 int client_destroy(struct client *c)
 801 {
 802     if (c)
 803     {
 804         yaz_log(YLOG_DEBUG, "client_destroy c=%p %s cnt=%d",
 805                 c, client_get_url(c), c->ref_count);
 806         if (!pazpar2_decref(&c->ref_count, c->mutex))
 807         {
 808             xfree(c->pquery);
 809             c->pquery = 0;
 810             xfree(c->cqlquery);
 811             c->cqlquery = 0;
 812             xfree(c->url);
 813             assert(!c->connection);
 814
 815             if (c->resultset)
 816             {
 817                 ZOOM_resultset_destroy(c->resultset);
 818             }
 819             yaz_mutex_destroy(&c->mutex);
 820             xfree(c);
 821             client_use(-1);
 822             return 1;
 823         }
 824     }
 825     return 0;
 826 }
 827
 828 void client_set_connection(struct client *cl, struct connection *con)
 829 {
 830     if (cl->resultset)
 831         ZOOM_resultset_release(cl->resultset);
 832     if (con)
 833     {
 834         assert(cl->connection == 0);
 835         cl->connection = con;
 836         client_incref(cl);
 837     }
 838     else
 839     {
 840         cl->connection = con;
 841         client_destroy(cl);
 842     }
 843 }
 844
 845 void client_disconnect(struct client *cl)
 846 {
 847     if (cl->state != Client_Idle)
 848         client_set_state(cl, Client_Disconnected);
 849     client_set_connection(cl, 0);
 850 }
 851
 852 // Extract terms from query into null-terminated termlist
 853 static void extract_terms(NMEM nmem, struct ccl_rpn_node *query, char **termlist)
 854 {
 855     int num = 0;
 856
 857     pull_terms(nmem, query, termlist, &num);
 858     termlist[num] = 0;
 859 }
 860
 861 // Initialize CCL map for a target
 862 static CCL_bibset prepare_cclmap(struct client *cl)
 863 {
 864     struct session_database *sdb = client_get_database(cl);
 865     struct setting *s;
 866     CCL_bibset res;
 867
 868     if (!sdb->settings)
 869         return 0;
 870     res = ccl_qual_mk();
 871     for (s = sdb->settings[PZ_CCLMAP]; s; s = s->next)
 872     {
 873         char *p = strchr(s->name + 3, ':');
 874         if (!p)
 875         {
 876             yaz_log(YLOG_WARN, "Malformed cclmap name: %s", s->name);
 877             ccl_qual_rm(&res);
 878             return 0;
 879         }
 880         p++;
 881         ccl_qual_fitem(res, s->value, p);
 882     }
 883     return res;
 884 }
 885
 886 // returns a xmalloced CQL query corresponding to the pquery in client
 887 static char *make_cqlquery(struct client *cl)
 888 {
 889     cql_transform_t cqlt = cql_transform_create();
 890     Z_RPNQuery *zquery;
 891     char *r;
 892     WRBUF wrb = wrbuf_alloc();
 893     int status;
 894     ODR odr_out = odr_createmem(ODR_ENCODE);
 895
 896     zquery = p_query_rpn(odr_out, cl->pquery);
 897     yaz_log(YLOG_LOG, "PQF: %s", cl->pquery);
 898     if ((status = cql_transform_rpn2cql_wrbuf(cqlt, wrb, zquery)))
 899     {
 900         yaz_log(YLOG_WARN, "Failed to generate CQL query, code=%d", status);
 901         r = 0;
 902     }
 903     else
 904     {
 905         r = xstrdup(wrbuf_cstr(wrb));
 906     }
 907     wrbuf_destroy(wrb);
 908     odr_destroy(odr_out);
 909     cql_transform_close(cqlt);
 910     return r;
 911 }
 912
 913 // returns a xmalloced SOLR query corresponding to the pquery in client
 914 // TODO Could prob. be merge with the similar make_cqlquery
 915 static char *make_solrquery(struct client *cl)
 916 {
 917     solr_transform_t sqlt = solr_transform_create();
 918     Z_RPNQuery *zquery;
 919     char *r;
 920     WRBUF wrb = wrbuf_alloc();
 921     int status;
 922     ODR odr_out = odr_createmem(ODR_ENCODE);
 923
 924     zquery = p_query_rpn(odr_out, cl->pquery);
 925     yaz_log(YLOG_LOG, "PQF: %s", cl->pquery);
 926     if ((status = solr_transform_rpn2solr_wrbuf(sqlt, wrb, zquery)))
 927     {
 928         yaz_log(YLOG_WARN, "Failed to generate SOLR query, code=%d", status);
 929         r = 0;
 930     }
 931     else
 932     {
 933         r = xstrdup(wrbuf_cstr(wrb));
 934     }
 935     wrbuf_destroy(wrb);
 936     odr_destroy(odr_out);
 937     solr_transform_close(sqlt);
 938     return r;
 939 }
 940
 941 // Parse the query given the settings specific to this client
 942 int client_parse_query(struct client *cl, const char *query)
 943 {
 944     struct session *se = client_get_session(cl);
 945     struct session_database *sdb = client_get_database(cl);
 946     struct ccl_rpn_node *cn;
 947     struct ccl_rpn_node *cn_recordfilter = 0;
 948     int cerror, cpos;
 949     CCL_bibset ccl_map = prepare_cclmap(cl);
 950     const char *sru = session_setting_oneval(sdb, PZ_SRU);
 951     const char *pqf_prefix = session_setting_oneval(sdb, PZ_PQF_PREFIX);
 952     const char *pqf_strftime = session_setting_oneval(sdb, PZ_PQF_STRFTIME);
 953     const char *query_syntax = session_setting_oneval(sdb, PZ_QUERY_SYNTAX);
 954     /* Collected, Mixed, Remote */
 955     const char *option_recordfilter = session_setting_oneval(sdb, PZ_OPTION_RECORDFILTER);
 956     const char *record_filter = session_setting_oneval(sdb, PZ_RECORDFILTER);
 957     if (!ccl_map)
 958         return -1;
 959
 960     yaz_log(YLOG_DEBUG, "query: %s", query);
 961     cn = ccl_find_str(ccl_map, query, &cerror, &cpos);
 962     if (strcmp("remote", option_recordfilter) == 0 && record_filter != 0 && record_filter[0] != 0) {
 963         int cerror, cpos;
 964         yaz_log(YLOG_DEBUG, "record_filter: %s", record_filter);
 965         cn_recordfilter = ccl_find_str(ccl_map, record_filter, &cerror, &cpos);
 966         if (!cn_recordfilter)
 967             session_log(se, YLOG_WARN, "Failed to parse CCL record filter '%s' for %s",
 968                     record_filter, client_get_database(cl)->database->url);
 969     }
 970     ccl_qual_rm(&ccl_map);
 971     if (!cn)
 972     {
 973         client_set_state(cl, Client_Error);
 974         session_log(se, YLOG_WARN, "Failed to parse CCL query '%s' for %s",
 975                 query,
 976                 client_get_database(cl)->database->url);
 977         return -1;
 978     }
 979     wrbuf_rewind(se->wrbuf);
 980     if (*pqf_prefix)
 981     {
 982         wrbuf_puts(se->wrbuf, pqf_prefix);
 983         wrbuf_puts(se->wrbuf, " ");
 984     }
 985
 986     if (cn_recordfilter) {
 987         wrbuf_puts(se->wrbuf, "@and ");
 988         ccl_pquery(se->wrbuf, cn_recordfilter);
 989         wrbuf_puts(se->wrbuf, " ");
 990     }
 991
 992     if (!pqf_strftime || !*pqf_strftime)
 993         ccl_pquery(se->wrbuf, cn);
 994     else
 995     {
 996         time_t cur_time = time(0);
 997         struct tm *tm =  localtime(&cur_time);
 998         char tmp_str[300];
 999         const char *cp = tmp_str;
1000
1001         /* see man strftime(3) for things .. In particular %% gets converted
1002          to %.. And That's our original query .. */
1003         strftime(tmp_str, sizeof(tmp_str)-1, pqf_strftime, tm);
1004         for (; *cp; cp++)
1005         {
1006             if (cp[0] == '%')
1007                 ccl_pquery(se->wrbuf, cn);
1008             else
1009                 wrbuf_putc(se->wrbuf, cp[0]);
1010         }
1011     }
1012     xfree(cl->pquery);
1013     cl->pquery = xstrdup(wrbuf_cstr(se->wrbuf));
1014
1015     yaz_log(YLOG_DEBUG, "PQF query: %s", cl->pquery);
1016
1017     xfree(cl->cqlquery);
1018
1019     /* Support for PQF on SRU targets. */
1020     /* TODO Refactor */
1021     yaz_log(YLOG_DEBUG, "Query syntax: %s", query_syntax);
1022     if (strcmp(query_syntax, "pqf") != 0 && *sru)
1023     {
1024         if (!strcmp(sru, "solr")) {
1025             if (!(cl->cqlquery = make_solrquery(cl)))
1026                 return -1;
1027         }
1028         else {
1029             if (!(cl->cqlquery = make_cqlquery(cl)))
1030                 return -1;
1031         }
1032     }
1033     else
1034         cl->cqlquery = 0;
1035
1036     /* TODO FIX Not thread safe */
1037     if (!se->relevance)
1038     {
1039         // Initialize relevance structure with query terms
1040         char *p[512];
1041         extract_terms(se->nmem, cn, p);
1042         se->relevance = relevance_create(
1043             se->service->relevance_pct,
1044             se->nmem, (const char **) p);
1045     }
1046
1047     ccl_rpn_delete(cn);
1048     return 0;
1049 }
1050
1051 void client_set_session(struct client *cl, struct session *se)
1052 {
1053     cl->session = se;
1054 }
1055
1056 int client_is_active(struct client *cl)
1057 {
1058     if (cl->connection && (cl->state == Client_Connecting ||
1059                            cl->state == Client_Working))
1060         return 1;
1061     return 0;
1062 }
1063
1064 int client_is_active_preferred(struct client *cl)
1065 {
1066     /* only count if this is a preferred target. */
1067     if (!cl->preferred)
1068         return 0;
1069     /* TODO No sure this the condition that Seb wants */
1070     if (cl->connection && (cl->state == Client_Connecting ||
1071                            cl->state == Client_Working))
1072         return 1;
1073     return 0;
1074 }
1075
1076
1077 Odr_int client_get_hits(struct client *cl)
1078 {
1079     return cl->hits;
1080 }
1081
1082 int client_get_num_records(struct client *cl)
1083 {
1084     return cl->record_offset;
1085 }
1086
1087 void client_set_diagnostic(struct client *cl, int diagnostic)
1088 {
1089     cl->diagnostic = diagnostic;
1090 }
1091
1092 int client_get_diagnostic(struct client *cl)
1093 {
1094     return cl->diagnostic;
1095 }
1096
1097 void client_set_database(struct client *cl, struct session_database *db)
1098 {
1099     cl->database = db;
1100     /* Copy the URL for safe logging even after session is gone */
1101     if (db) {
1102         cl->url = xstrdup(db->database->url);
1103     }
1104 }
1105
1106 struct host *client_get_host(struct client *cl)
1107 {
1108     return client_get_database(cl)->database->host;
1109 }
1110
1111 const char *client_get_url(struct client *cl)
1112 {
1113     if (cl->url)
1114         return cl->url;
1115     else
1116         /* This must not happen anymore, as the url is present until destruction of client  */
1117         return "NOURL";
1118 }
1119
1120 void client_set_maxrecs(struct client *cl, int v)
1121 {
1122     cl->maxrecs = v;
1123 }
1124
1125 int client_get_maxrecs(struct client *cl)
1126 {
1127     return cl->maxrecs;
1128 }
1129
1130 void client_set_startrecs(struct client *cl, int v)
1131 {
1132     cl->startrecs = v;
1133 }
1134
1135 void client_set_preferred(struct client *cl, int v)
1136 {
1137     cl->preferred = v;
1138 }
1139
1140
1141 /*
1142  * Local variables:
1143  * c-basic-offset: 4
1144  * c-file-style: "Stroustrup"
1145  * indent-tabs-mode: nil
1146  * End:
1147  * vim: shiftwidth=4 tabstop=8 expandtab
1148  */
1149