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     struct suggestions *suggestions;
 118     enum client_state state;
 119     struct show_raw *show_raw;
 120     ZOOM_resultset resultset;
 121     YAZ_MUTEX mutex;
 122     int ref_count;
 123     char *id;
 124 };
 125
 126 struct suggestions {
 127     NMEM nmem;
 128     int num;
 129     char **misspelled;
 130     char **suggest;
 131     char *passthrough;
 132 };
 133
 134 struct show_raw {
 135     int active; // whether this request has been sent to the server
 136     int position;
 137     int binary;
 138     char *syntax;
 139     char *esn;
 140     void (*error_handler)(void *data, const char *addinfo);
 141     void (*record_handler)(void *data, const char *buf, size_t sz);
 142     void *data;
 143     struct show_raw *next;
 144 };
 145
 146 static const char *client_states[] = {
 147     "Client_Connecting",
 148     "Client_Idle",
 149     "Client_Working",
 150     "Client_Error",
 151     "Client_Failed",
 152     "Client_Disconnected"
 153 };
 154
 155 const char *client_get_state_str(struct client *cl)
 156 {
 157     return client_states[cl->state];
 158 }
 159
 160 enum client_state client_get_state(struct client *cl)
 161 {
 162     return cl->state;
 163 }
 164
 165 void client_set_state_nb(struct client *cl, enum client_state st)
 166 {
 167     cl->state = st;
 168 }
 169
 170 void client_set_state(struct client *cl, enum client_state st)
 171 {
 172     int was_active = 0;
 173     if (client_is_active(cl))
 174         was_active = 1;
 175     cl->state = st;
 176     /* If client is going from being active to inactive and all clients
 177        are now idle we fire a watch for the session . The assumption is
 178        that session is not mutex locked if client is already active */
 179     if (was_active && !client_is_active(cl) && cl->session)
 180     {
 181
 182         int no_active = session_active_clients(cl->session);
 183         yaz_log(YLOG_DEBUG, "%s: releasing watches on zero active: %d",
 184                 client_get_id(cl), no_active);
 185         if (no_active == 0) {
 186             session_alert_watch(cl->session, SESSION_WATCH_SHOW);
 187             session_alert_watch(cl->session, SESSION_WATCH_BYTARGET);
 188             session_alert_watch(cl->session, SESSION_WATCH_TERMLIST);
 189             session_alert_watch(cl->session, SESSION_WATCH_SHOW_PREF);
 190         }
 191     }
 192 }
 193
 194 static void client_show_raw_error(struct client *cl, const char *addinfo);
 195
 196 struct connection *client_get_connection(struct client *cl)
 197 {
 198     return cl->connection;
 199 }
 200
 201 struct session_database *client_get_database(struct client *cl)
 202 {
 203     return cl->database;
 204 }
 205
 206 struct session *client_get_session(struct client *cl)
 207 {
 208     return cl->session;
 209 }
 210
 211 const char *client_get_pquery(struct client *cl)
 212 {
 213     return cl->pquery;
 214 }
 215
 216 static void client_send_raw_present(struct client *cl);
 217 static int nativesyntax_to_type(struct session_database *sdb, char *type,
 218                                 ZOOM_record rec);
 219
 220 static void client_show_immediate(
 221     ZOOM_resultset resultset, struct session_database *sdb, int position,
 222     void *data,
 223     void (*error_handler)(void *data, const char *addinfo),
 224     void (*record_handler)(void *data, const char *buf, size_t sz),
 225     int binary)
 226 {
 227     ZOOM_record rec = 0;
 228     char type[80];
 229     const char *buf;
 230     int len;
 231
 232     if (!resultset)
 233     {
 234         error_handler(data, "no resultset");
 235         return;
 236     }
 237     rec = ZOOM_resultset_record(resultset, position-1);
 238     if (!rec)
 239     {
 240         error_handler(data, "no record");
 241         return;
 242     }
 243     if (binary)
 244         strcpy(type, "raw");
 245     else
 246         nativesyntax_to_type(sdb, type, rec);
 247     buf = ZOOM_record_get(rec, type, &len);
 248     if (!buf)
 249     {
 250         error_handler(data, "no record");
 251         return;
 252     }
 253     record_handler(data, buf, len);
 254 }
 255
 256
 257 int client_show_raw_begin(struct client *cl, int position,
 258                           const char *syntax, const char *esn,
 259                           void *data,
 260                           void (*error_handler)(void *data, const char *addinfo),
 261                           void (*record_handler)(void *data, const char *buf,
 262                                                  size_t sz),
 263                           int binary)
 264 {
 265     if (syntax == 0 && esn == 0)
 266         client_show_immediate(cl->resultset, client_get_database(cl),
 267                               position, data,
 268                               error_handler, record_handler,
 269                               binary);
 270     else
 271     {
 272         struct show_raw *rr, **rrp;
 273
 274         if (!cl->connection)
 275             return -1;
 276
 277
 278         rr = xmalloc(sizeof(*rr));
 279         rr->position = position;
 280         rr->active = 0;
 281         rr->data = data;
 282         rr->error_handler = error_handler;
 283         rr->record_handler = record_handler;
 284         rr->binary = binary;
 285         if (syntax)
 286             rr->syntax = xstrdup(syntax);
 287         else
 288             rr->syntax = 0;
 289         if (esn)
 290             rr->esn = xstrdup(esn);
 291         else
 292             rr->esn = 0;
 293         rr->next = 0;
 294
 295         for (rrp = &cl->show_raw; *rrp; rrp = &(*rrp)->next)
 296             ;
 297         *rrp = rr;
 298
 299         if (cl->state == Client_Failed)
 300         {
 301             client_show_raw_error(cl, "client failed");
 302         }
 303         else if (cl->state == Client_Disconnected)
 304         {
 305             client_show_raw_error(cl, "client disconnected");
 306         }
 307         else
 308         {
 309             client_send_raw_present(cl);
 310         }
 311     }
 312     return 0;
 313 }
 314
 315 static void client_show_raw_delete(struct show_raw *r)
 316 {
 317     xfree(r->syntax);
 318     xfree(r->esn);
 319     xfree(r);
 320 }
 321
 322 void client_show_raw_remove(struct client *cl, void *data)
 323 {
 324     struct show_raw *rr = data;
 325     struct show_raw **rrp = &cl->show_raw;
 326     while (*rrp != rr)
 327         rrp = &(*rrp)->next;
 328     if (*rrp)
 329     {
 330         *rrp = rr->next;
 331         client_show_raw_delete(rr);
 332     }
 333 }
 334
 335 void client_show_raw_dequeue(struct client *cl)
 336 {
 337     struct show_raw *rr = cl->show_raw;
 338
 339     cl->show_raw = rr->next;
 340     client_show_raw_delete(rr);
 341 }
 342
 343 static void client_show_raw_error(struct client *cl, const char *addinfo)
 344 {
 345     while (cl->show_raw)
 346     {
 347         cl->show_raw->error_handler(cl->show_raw->data, addinfo);
 348         client_show_raw_dequeue(cl);
 349     }
 350 }
 351
 352 static void client_send_raw_present(struct client *cl)
 353 {
 354     struct session_database *sdb = client_get_database(cl);
 355     struct connection *co = client_get_connection(cl);
 356     ZOOM_resultset set = cl->resultset;
 357
 358     int offset = cl->show_raw->position;
 359     const char *syntax = 0;
 360     const char *elements = 0;
 361
 362     assert(cl->show_raw);
 363     assert(set);
 364
 365     yaz_log(YLOG_DEBUG, "%s: trying to present %d record(s) from %d",
 366             client_get_id(cl), 1, offset);
 367
 368     if (cl->show_raw->syntax)
 369         syntax = cl->show_raw->syntax;
 370     else
 371         syntax = session_setting_oneval(sdb, PZ_REQUESTSYNTAX);
 372     ZOOM_resultset_option_set(set, "preferredRecordSyntax", syntax);
 373
 374     if (cl->show_raw->esn)
 375         elements = cl->show_raw->esn;
 376     else
 377         elements = session_setting_oneval(sdb, PZ_ELEMENTS);
 378     if (elements && *elements)
 379         ZOOM_resultset_option_set(set, "elementSetName", elements);
 380
 381     ZOOM_resultset_records(set, 0, offset-1, 1);
 382     cl->show_raw->active = 1;
 383
 384     connection_continue(co);
 385 }
 386
 387 static int nativesyntax_to_type(struct session_database *sdb, char *type,
 388                                 ZOOM_record rec)
 389 {
 390     const char *s = session_setting_oneval(sdb, PZ_NATIVESYNTAX);
 391
 392     if (s && *s)
 393     {
 394         if (!strncmp(s, "iso2709", 7))
 395         {
 396             const char *cp = strchr(s, ';');
 397             yaz_snprintf(type, 80, "xml; charset=%s", cp ? cp+1 : "marc-8s");
 398         }
 399         else if (!strncmp(s, "xml", 3))
 400         {
 401             strcpy(type, "xml");
 402         }
 403         else if (!strncmp(s, "txml", 4))
 404         {
 405             const char *cp = strchr(s, ';');
 406             yaz_snprintf(type, 80, "txml; charset=%s", cp ? cp+1 : "marc-8s");
 407         }
 408         else
 409             return -1;
 410         return 0;
 411     }
 412     else  /* attempt to deduce structure */
 413     {
 414         const char *syntax = ZOOM_record_get(rec, "syntax", NULL);
 415         if (syntax)
 416         {
 417             if (!strcmp(syntax, "XML"))
 418             {
 419                 strcpy(type, "xml");
 420                 return 0;
 421             }
 422             else if (!strcmp(syntax, "USmarc") || !strcmp(syntax, "MARC21"))
 423             {
 424                 strcpy(type, "xml; charset=marc8-s");
 425                 return 0;
 426             }
 427             else return -1;
 428         }
 429         else return -1;
 430     }
 431 }
 432
 433 /**
 434  * TODO Consider thread safety!!!
 435  *
 436  */
 437 void client_report_facets(struct client *cl, ZOOM_resultset rs)
 438 {
 439     struct session_database *sdb = client_get_database(cl);
 440     ZOOM_facet_field *facets = ZOOM_resultset_facets(rs);
 441
 442     if (sdb && facets)
 443     {
 444         struct session *se = client_get_session(cl);
 445         int facet_num = ZOOM_resultset_facets_size(rs);
 446         struct setting *s;
 447
 448         for (s = sdb->settings[PZ_FACETMAP]; s; s = s->next)
 449         {
 450             const char *p = strchr(s->name + 3, ':');
 451             if (p && p[1] && s->value && s->value[0])
 452             {
 453                 int facet_idx;
 454                 p++; /* p now holds logical facet name */
 455                 for (facet_idx = 0; facet_idx < facet_num; facet_idx++)
 456                 {
 457                     const char *native_name =
 458                         ZOOM_facet_field_name(facets[facet_idx]);
 459                     if (native_name && !strcmp(s->value, native_name))
 460                     {
 461                         size_t term_idx;
 462                         size_t term_num =
 463                             ZOOM_facet_field_term_count(facets[facet_idx]);
 464                         for (term_idx = 0; term_idx < term_num; term_idx++ )
 465                         {
 466                             int freq;
 467                             const char *term =
 468                                 ZOOM_facet_field_get_term(facets[facet_idx],
 469                                                           term_idx, &freq);
 470                             if (term)
 471                                 add_facet(se, p, term, freq);
 472                         }
 473                         break;
 474                     }
 475                 }
 476             }
 477         }
 478     }
 479 }
 480
 481 static void ingest_raw_record(struct client *cl, ZOOM_record rec)
 482 {
 483     const char *buf;
 484     int len;
 485     char type[80];
 486
 487     if (cl->show_raw->binary)
 488         strcpy(type, "raw");
 489     else
 490     {
 491         struct session_database *sdb = client_get_database(cl);
 492         nativesyntax_to_type(sdb, type, rec);
 493     }
 494
 495     buf = ZOOM_record_get(rec, type, &len);
 496     cl->show_raw->record_handler(cl->show_raw->data,  buf, len);
 497     client_show_raw_dequeue(cl);
 498 }
 499
 500 void client_check_preferred_watch(struct client *cl)
 501 {
 502     struct session *se = cl->session;
 503     yaz_log(YLOG_DEBUG, "client_check_preferred_watch: %s ", client_get_id(cl));
 504     if (se)
 505     {
 506         client_unlock(cl);
 507         /* TODO possible threading issue. Session can have been destroyed */
 508         if (session_is_preferred_clients_ready(se)) {
 509             session_alert_watch(se, SESSION_WATCH_SHOW_PREF);
 510         }
 511         else
 512             yaz_log(YLOG_DEBUG, "client_check_preferred_watch: Still locked on preferred targets.");
 513
 514         client_lock(cl);
 515     }
 516     else
 517         yaz_log(YLOG_WARN, "client_check_preferred_watch: %s. No session!", client_get_id(cl));
 518
 519 }
 520
 521 struct suggestions* client_suggestions_create(const char* suggestions_string);
 522 static void client_suggestions_destroy(struct client *cl);
 523
 524 void client_search_response(struct client *cl)
 525 {
 526     struct connection *co = cl->connection;
 527     ZOOM_connection link = connection_get_link(co);
 528     ZOOM_resultset resultset = cl->resultset;
 529
 530     const char *error, *addinfo = 0;
 531
 532     if (ZOOM_connection_error(link, &error, &addinfo))
 533     {
 534         cl->hits = 0;
 535         client_set_state(cl, Client_Error);
 536         yaz_log(YLOG_WARN, "Search error %s (%s): %s",
 537                 error, addinfo, client_get_id(cl));
 538     }
 539     else
 540     {
 541         yaz_log(YLOG_DEBUG, "client_search_response: hits "
 542                 ODR_INT_PRINTF, cl->hits);
 543         client_report_facets(cl, resultset);
 544         cl->record_offset = cl->startrecs;
 545         cl->hits = ZOOM_resultset_size(resultset);
 546         if (cl->suggestions)
 547             client_suggestions_destroy(cl);
 548         cl->suggestions = client_suggestions_create(ZOOM_resultset_option_get(resultset, "suggestions"));
 549     }
 550 }
 551
 552 void client_got_records(struct client *cl)
 553 {
 554     struct session *se = cl->session;
 555     if (se)
 556     {
 557         client_unlock(cl);
 558         session_alert_watch(se, SESSION_WATCH_SHOW);
 559         session_alert_watch(se, SESSION_WATCH_BYTARGET);
 560         session_alert_watch(se, SESSION_WATCH_TERMLIST);
 561         session_alert_watch(se, SESSION_WATCH_RECORD);
 562         client_lock(cl);
 563     }
 564 }
 565
 566 void client_record_response(struct client *cl)
 567 {
 568     struct connection *co = cl->connection;
 569     ZOOM_connection link = connection_get_link(co);
 570     ZOOM_resultset resultset = cl->resultset;
 571     const char *error, *addinfo;
 572
 573     if (ZOOM_connection_error(link, &error, &addinfo))
 574     {
 575         client_set_state(cl, Client_Error);
 576         yaz_log(YLOG_WARN, "Search error %s (%s): %s",
 577             error, addinfo, client_get_id(cl));
 578     }
 579     else
 580     {
 581         ZOOM_record rec = 0;
 582         const char *msg, *addinfo;
 583
 584         if (cl->show_raw && cl->show_raw->active)
 585         {
 586             if ((rec = ZOOM_resultset_record(resultset,
 587                                              cl->show_raw->position-1)))
 588             {
 589                 cl->show_raw->active = 0;
 590                 ingest_raw_record(cl, rec);
 591             }
 592             else
 593             {
 594                 yaz_log(YLOG_WARN, "Expected record, but got NULL, offset=%d",
 595                         cl->show_raw->position-1);
 596             }
 597         }
 598         else
 599         {
 600             int offset = cl->record_offset;
 601             if ((rec = ZOOM_resultset_record(resultset, offset)))
 602             {
 603                 cl->record_offset++;
 604                 if (cl->session == 0)
 605                     ;
 606                 else if (ZOOM_record_error(rec, &msg, &addinfo, 0))
 607                 {
 608                     yaz_log(YLOG_WARN, "Record error %s (%s): %s (rec #%d)",
 609                             msg, addinfo, client_get_id(cl),
 610                             cl->record_offset);
 611                 }
 612                 else
 613                 {
 614                     struct session_database *sdb = client_get_database(cl);
 615                     NMEM nmem = nmem_create();
 616                     const char *xmlrec;
 617                     char type[80];
 618
 619                     if (nativesyntax_to_type(sdb, type, rec))
 620                         yaz_log(YLOG_WARN, "Failed to determine record type");
 621                     xmlrec = ZOOM_record_get(rec, type, NULL);
 622                     if (!xmlrec)
 623                         yaz_log(YLOG_WARN, "ZOOM_record_get failed from %s",
 624                                 client_get_id(cl));
 625                     else
 626                     {
 627                         /* OK = 0, -1 = failure, -2 = Filtered */
 628                         if (ingest_record(cl, xmlrec, cl->record_offset, nmem) == -1)
 629                             yaz_log(YLOG_WARN, "Failed to ingest from %s", client_get_id(cl));
 630                     }
 631                     nmem_destroy(nmem);
 632                 }
 633             }
 634             else
 635             {
 636                 yaz_log(YLOG_WARN, "Expected record, but got NULL, offset=%d",
 637                         offset);
 638             }
 639         }
 640     }
 641 }
 642
 643 static void client_set_facets_request(struct client *cl, ZOOM_connection link)
 644 {
 645     struct session_database *sdb = client_get_database(cl);
 646
 647     WRBUF w = wrbuf_alloc();
 648
 649     struct setting *s;
 650
 651     for (s = sdb->settings[PZ_FACETMAP]; s; s = s->next)
 652     {
 653         const char *p = strchr(s->name + 3, ':');
 654         if (!p)
 655         {
 656             yaz_log(YLOG_WARN, "Malformed facetmap name: %s", s->name);
 657         }
 658         else if (s->value && s->value[0])
 659         {
 660             wrbuf_puts(w, "@attr 1=");
 661             yaz_encode_pqf_term(w, s->value, strlen(s->value));
 662             if (s->next)
 663                 wrbuf_puts(w, ",");
 664         }
 665     }
 666     yaz_log(YLOG_LOG, "using facets str: %s", wrbuf_cstr(w));
 667     ZOOM_connection_option_set(link, "facets",
 668                                wrbuf_len(w) ? wrbuf_cstr(w) : 0);
 669     wrbuf_destroy(w);
 670 }
 671
 672 int client_has_facet(struct client *cl, const char *name)
 673 {
 674     struct session_database *sdb = client_get_database(cl);
 675     struct setting *s;
 676
 677     for (s = sdb->settings[PZ_FACETMAP]; s; s = s->next)
 678     {
 679         const char *p = strchr(s->name + 3, ':');
 680         if (p && !strcmp(name, p + 1))
 681             return 1;
 682     }
 683     return 0;
 684 }
 685
 686 static const char *get_strategy_plus_sort(struct client *l, const char *field)
 687 {
 688     struct session_database *sdb = client_get_database(l);
 689     struct setting *s;
 690
 691     const char *strategy_plus_sort = 0;
 692
 693     for (s = sdb->settings[PZ_SORTMAP]; s; s = s->next)
 694     {
 695         char *p = strchr(s->name + 3, ':');
 696         if (!p)
 697         {
 698             yaz_log(YLOG_WARN, "Malformed sortmap name: %s", s->name);
 699             continue;
 700         }
 701         p++;
 702         if (!strcmp(p, field))
 703         {
 704             strategy_plus_sort = s->value;
 705             break;
 706         }
 707     }
 708     return strategy_plus_sort;
 709 }
 710
 711 void client_start_search(struct client *cl)
 712 {
 713     struct session_database *sdb = client_get_database(cl);
 714     struct connection *co = client_get_connection(cl);
 715     ZOOM_connection link = connection_get_link(co);
 716     struct session *se = client_get_session(cl);
 717     ZOOM_resultset rs;
 718     const char *opt_piggyback   = session_setting_oneval(sdb, PZ_PIGGYBACK);
 719     const char *opt_queryenc    = session_setting_oneval(sdb, PZ_QUERYENCODING);
 720     const char *opt_elements    = session_setting_oneval(sdb, PZ_ELEMENTS);
 721     const char *opt_requestsyn  = session_setting_oneval(sdb, PZ_REQUESTSYNTAX);
 722     const char *opt_maxrecs     = session_setting_oneval(sdb, PZ_MAXRECS);
 723     const char *opt_sru         = session_setting_oneval(sdb, PZ_SRU);
 724     const char *opt_sort        = session_setting_oneval(sdb, PZ_SORT);
 725     const char *opt_preferred   = session_setting_oneval(sdb, PZ_PREFERRED);
 726     const char *extra_args      = session_setting_oneval(sdb, PZ_EXTRA_ARGS);
 727     char maxrecs_str[24], startrecs_str[24];
 728     ZOOM_query q;
 729
 730     assert(link);
 731
 732     cl->record_offset = 0;
 733     cl->diagnostic = 0;
 734
 735     if (extra_args && *extra_args)
 736         ZOOM_connection_option_set(link, "extraArgs", extra_args);
 737
 738     if (opt_preferred) {
 739         cl->preferred = atoi(opt_preferred);
 740         if (cl->preferred)
 741             yaz_log(YLOG_LOG, "Target %s has preferred status: %d",
 742                     client_get_id(cl), cl->preferred);
 743     }
 744     client_set_state(cl, Client_Working);
 745
 746     if (*opt_piggyback)
 747         ZOOM_connection_option_set(link, "piggyback", opt_piggyback);
 748     else
 749         ZOOM_connection_option_set(link, "piggyback", "1");
 750     if (*opt_queryenc)
 751         ZOOM_connection_option_set(link, "rpnCharset", opt_queryenc);
 752     if (*opt_sru && *opt_elements)
 753         ZOOM_connection_option_set(link, "schema", opt_elements);
 754     else if (*opt_elements)
 755         ZOOM_connection_option_set(link, "elementSetName", opt_elements);
 756     if (*opt_requestsyn)
 757         ZOOM_connection_option_set(link, "preferredRecordSyntax", opt_requestsyn);
 758
 759     if (opt_maxrecs && *opt_maxrecs)
 760     {
 761         cl->maxrecs = atoi(opt_maxrecs);
 762     }
 763
 764     /* convert back to string representation used in ZOOM API */
 765     sprintf(maxrecs_str, "%d", cl->maxrecs);
 766     ZOOM_connection_option_set(link, "count", maxrecs_str);
 767
 768     if (cl->maxrecs > 20)
 769         ZOOM_connection_option_set(link, "presentChunk", "20");
 770     else
 771         ZOOM_connection_option_set(link, "presentChunk", maxrecs_str);
 772
 773     sprintf(startrecs_str, "%d", cl->startrecs);
 774     ZOOM_connection_option_set(link, "start", startrecs_str);
 775
 776     /* TODO Verify does it break something for CQL targets(non-SOLR) ? */
 777     /* facets definition is in PQF */
 778     client_set_facets_request(cl, link);
 779
 780     q = ZOOM_query_create();
 781     if (cl->cqlquery)
 782     {
 783         yaz_log(YLOG_LOG, "Search %s CQL: %s", client_get_id(cl),
 784                 cl->cqlquery);
 785         ZOOM_query_cql(q, cl->cqlquery);
 786         if (*opt_sort)
 787             ZOOM_query_sortby(q, opt_sort);
 788     }
 789     else
 790     {
 791         yaz_log(YLOG_LOG, "Search %s PQF: %s", client_get_id(cl), cl->pquery);
 792
 793         ZOOM_query_prefix(q, cl->pquery);
 794     }
 795     if (se->sorted_results)
 796     {   /* first entry is current sorting ! */
 797         const char *sort_strategy_and_spec =
 798             get_strategy_plus_sort(cl, se->sorted_results->field);
 799         int increasing = se->sorted_results->increasing;
 800         if (sort_strategy_and_spec && strlen(sort_strategy_and_spec) < 40)
 801         {
 802             char spec[50], *p;
 803             strcpy(spec, sort_strategy_and_spec);
 804             p = strchr(spec, ':');
 805             if (p)
 806             {
 807                 *p++ = '\0'; /* cut the string in two */
 808                 while (*p == ' ')
 809                     p++;
 810                 if (increasing)
 811                     strcat(p, " <");
 812                 else
 813                     strcat(p, " >");
 814                 yaz_log(YLOG_LOG, "applying %s %s", spec, p);
 815                 ZOOM_query_sortby2(q, spec, p);
 816             }
 817         }
 818         else
 819         {
 820             /* no native sorting.. If this is not the first search, then
 821                skip it entirely */
 822             if (se->sorted_results->next)
 823             {
 824                 ZOOM_query_destroy(q);
 825                 client_set_state_nb(cl, Client_Idle);
 826                 return;
 827             }
 828         }
 829     }
 830     rs = ZOOM_connection_search(link, q);
 831     ZOOM_query_destroy(q);
 832     ZOOM_resultset_destroy(cl->resultset);
 833     cl->resultset = rs;
 834     connection_continue(co);
 835 }
 836
 837 struct client *client_create(const char *id)
 838 {
 839     struct client *cl = xmalloc(sizeof(*cl));
 840     cl->maxrecs = 100;
 841     cl->startrecs = 0;
 842     cl->pquery = 0;
 843     cl->cqlquery = 0;
 844     cl->database = 0;
 845     cl->connection = 0;
 846     cl->session = 0;
 847     cl->hits = 0;
 848     cl->record_offset = 0;
 849     cl->diagnostic = 0;
 850     cl->state = Client_Disconnected;
 851     cl->show_raw = 0;
 852     cl->resultset = 0;
 853     cl->suggestions = 0;
 854     cl->mutex = 0;
 855     pazpar2_mutex_create(&cl->mutex, "client");
 856     cl->preferred = 0;
 857     cl->ref_count = 1;
 858     assert(id);
 859     cl->id = xstrdup(id);
 860     client_use(1);
 861
 862     return cl;
 863 }
 864
 865 void client_lock(struct client *c)
 866 {
 867     yaz_mutex_enter(c->mutex);
 868 }
 869
 870 void client_unlock(struct client *c)
 871 {
 872     yaz_mutex_leave(c->mutex);
 873 }
 874
 875 void client_incref(struct client *c)
 876 {
 877     pazpar2_incref(&c->ref_count, c->mutex);
 878     yaz_log(YLOG_DEBUG, "client_incref c=%p %s cnt=%d",
 879             c, client_get_id(c), c->ref_count);
 880 }
 881
 882 int client_destroy(struct client *c)
 883 {
 884     if (c)
 885     {
 886         yaz_log(YLOG_DEBUG, "client_destroy c=%p %s cnt=%d",
 887                 c, client_get_id(c), c->ref_count);
 888         if (!pazpar2_decref(&c->ref_count, c->mutex))
 889         {
 890             xfree(c->pquery);
 891             c->pquery = 0;
 892             xfree(c->cqlquery);
 893             c->cqlquery = 0;
 894             xfree(c->id);
 895             assert(!c->connection);
 896
 897             if (c->resultset)
 898             {
 899                 ZOOM_resultset_destroy(c->resultset);
 900             }
 901             yaz_mutex_destroy(&c->mutex);
 902             xfree(c);
 903             client_use(-1);
 904             return 1;
 905         }
 906     }
 907     return 0;
 908 }
 909
 910 void client_set_connection(struct client *cl, struct connection *con)
 911 {
 912     if (cl->resultset)
 913         ZOOM_resultset_release(cl->resultset);
 914     if (con)
 915     {
 916         assert(cl->connection == 0);
 917         cl->connection = con;
 918         client_incref(cl);
 919     }
 920     else
 921     {
 922         cl->connection = con;
 923         client_destroy(cl);
 924     }
 925 }
 926
 927 void client_disconnect(struct client *cl)
 928 {
 929     if (cl->state != Client_Idle)
 930         client_set_state(cl, Client_Disconnected);
 931     client_set_connection(cl, 0);
 932 }
 933
 934
 935 // Initialize CCL map for a target
 936 static CCL_bibset prepare_cclmap(struct client *cl)
 937 {
 938     struct session_database *sdb = client_get_database(cl);
 939     struct setting *s;
 940     CCL_bibset res;
 941
 942     if (!sdb->settings)
 943         return 0;
 944     res = ccl_qual_mk();
 945     for (s = sdb->settings[PZ_CCLMAP]; s; s = s->next)
 946     {
 947         char *p = strchr(s->name + 3, ':');
 948         if (!p)
 949         {
 950             yaz_log(YLOG_WARN, "Malformed cclmap name: %s", s->name);
 951             ccl_qual_rm(&res);
 952             return 0;
 953         }
 954         p++;
 955         ccl_qual_fitem(res, s->value, p);
 956     }
 957     return res;
 958 }
 959
 960 // returns a xmalloced CQL query corresponding to the pquery in client
 961 static char *make_cqlquery(struct client *cl)
 962 {
 963     cql_transform_t cqlt = cql_transform_create();
 964     Z_RPNQuery *zquery;
 965     char *r;
 966     WRBUF wrb = wrbuf_alloc();
 967     int status;
 968     ODR odr_out = odr_createmem(ODR_ENCODE);
 969
 970     zquery = p_query_rpn(odr_out, cl->pquery);
 971     yaz_log(YLOG_LOG, "PQF: %s", cl->pquery);
 972     if ((status = cql_transform_rpn2cql_wrbuf(cqlt, wrb, zquery)))
 973     {
 974         yaz_log(YLOG_WARN, "Failed to generate CQL query, code=%d", status);
 975         r = 0;
 976     }
 977     else
 978     {
 979         r = xstrdup(wrbuf_cstr(wrb));
 980     }
 981     wrbuf_destroy(wrb);
 982     odr_destroy(odr_out);
 983     cql_transform_close(cqlt);
 984     return r;
 985 }
 986
 987 // returns a xmalloced SOLR query corresponding to the pquery in client
 988 // TODO Could prob. be merge with the similar make_cqlquery
 989 static char *make_solrquery(struct client *cl)
 990 {
 991     solr_transform_t sqlt = solr_transform_create();
 992     Z_RPNQuery *zquery;
 993     char *r;
 994     WRBUF wrb = wrbuf_alloc();
 995     int status;
 996     ODR odr_out = odr_createmem(ODR_ENCODE);
 997
 998     zquery = p_query_rpn(odr_out, cl->pquery);
 999     if (zquery == 0) {
1000         yaz_log(YLOG_WARN, "Failed to generate RPN from PQF: %s", cl->pquery);
1001         return 0;
1002     }
1003     yaz_log(YLOG_LOG, "PQF: %s", cl->pquery);
1004     if ((status = solr_transform_rpn2solr_wrbuf(sqlt, wrb, zquery)))
1005     {
1006         yaz_log(YLOG_WARN, "Failed to generate SOLR query from PQF %s, code=%d", cl->pquery, status);
1007         r = 0;
1008     }
1009     else
1010     {
1011         r = xstrdup(wrbuf_cstr(wrb));
1012     }
1013     wrbuf_destroy(wrb);
1014     odr_destroy(odr_out);
1015     solr_transform_close(sqlt);
1016     return r;
1017 }
1018
1019 static void apply_limit(struct session_database *sdb,
1020                         facet_limits_t facet_limits,
1021                         WRBUF w_pqf, WRBUF w_ccl)
1022 {
1023     int i = 0;
1024     const char *name;
1025     const char *value;
1026     NMEM nmem_tmp = nmem_create();
1027     for (i = 0; (name = facet_limits_get(facet_limits, i, &value)); i++)
1028     {
1029         struct setting *s = 0;
1030
1031         for (s = sdb->settings[PZ_LIMITMAP]; s; s = s->next)
1032         {
1033             const char *p = strchr(s->name + 3, ':');
1034             if (p && !strcmp(p + 1, name) && s->value)
1035             {
1036                 char **values = 0;
1037                 int i, num = 0;
1038                 nmem_strsplit_escape2(nmem_tmp, "|", value, &values,
1039                                       &num, 1, '\\', 1);
1040
1041                 if (!strncmp(s->value, "rpn:", 4))
1042                 {
1043                     const char *pqf = s->value + 4;
1044
1045                     wrbuf_puts(w_pqf, "@and ");
1046                     wrbuf_puts(w_pqf, pqf);
1047                     wrbuf_puts(w_pqf, " ");
1048                     for (i = 0; i < num; i++)
1049                     {
1050                         if (i < num - 1)
1051                             wrbuf_puts(w_pqf, "@or ");
1052                         yaz_encode_pqf_term(w_pqf, values[i],
1053                                             strlen(values[i]));
1054                     }
1055                 }
1056                 else if (!strncmp(s->value, "ccl:", 4))
1057                 {
1058                     const char *ccl = s->value + 4;
1059
1060                     wrbuf_puts(w_ccl, " and (");
1061
1062                     for (i = 0; i < num; i++)
1063                     {
1064                         if (i)
1065                             wrbuf_puts(w_ccl, " or ");
1066                         wrbuf_puts(w_ccl, ccl);
1067                         wrbuf_puts(w_ccl, "=\"");
1068                         wrbuf_puts(w_ccl, values[i]);
1069                         wrbuf_puts(w_ccl, "\"");
1070                     }
1071                     wrbuf_puts(w_ccl, ")");
1072
1073                 }
1074                 break;
1075             }
1076         }
1077         nmem_reset(nmem_tmp);
1078         if (!s)
1079         {
1080             yaz_log(YLOG_WARN, "Target %s: limit %s used, but no limitmap defined",
1081                     (sdb->database ? sdb->database->id : "<no id>"), name);
1082         }
1083     }
1084     nmem_destroy(nmem_tmp);
1085 }
1086
1087 // Parse the query given the settings specific to this client
1088 int client_parse_query(struct client *cl, const char *query,
1089                        facet_limits_t facet_limits)
1090 {
1091     struct session *se = client_get_session(cl);
1092     struct session_database *sdb = client_get_database(cl);
1093     struct ccl_rpn_node *cn;
1094     int cerror, cpos;
1095     CCL_bibset ccl_map = prepare_cclmap(cl);
1096     const char *sru = session_setting_oneval(sdb, PZ_SRU);
1097     const char *pqf_prefix = session_setting_oneval(sdb, PZ_PQF_PREFIX);
1098     const char *pqf_strftime = session_setting_oneval(sdb, PZ_PQF_STRFTIME);
1099     const char *query_syntax = session_setting_oneval(sdb, PZ_QUERY_SYNTAX);
1100     WRBUF w_ccl, w_pqf;
1101     if (!ccl_map)
1102         return -1;
1103
1104     cl->hits = -1;
1105     w_ccl = wrbuf_alloc();
1106     wrbuf_puts(w_ccl, query);
1107
1108     w_pqf = wrbuf_alloc();
1109     if (*pqf_prefix)
1110     {
1111         wrbuf_puts(w_pqf, pqf_prefix);
1112         wrbuf_puts(w_pqf, " ");
1113     }
1114
1115     apply_limit(sdb, facet_limits, w_pqf, w_ccl);
1116
1117     yaz_log(YLOG_LOG, "CCL query: %s", wrbuf_cstr(w_ccl));
1118     cn = ccl_find_str(ccl_map, wrbuf_cstr(w_ccl), &cerror, &cpos);
1119     ccl_qual_rm(&ccl_map);
1120     if (!cn)
1121     {
1122         client_set_state(cl, Client_Error);
1123         session_log(se, YLOG_WARN, "Failed to parse CCL query '%s' for %s",
1124                     wrbuf_cstr(w_ccl),
1125                     client_get_id(cl));
1126         wrbuf_destroy(w_ccl);
1127         wrbuf_destroy(w_pqf);
1128         return -1;
1129     }
1130     wrbuf_destroy(w_ccl);
1131
1132     if (!pqf_strftime || !*pqf_strftime)
1133         ccl_pquery(w_pqf, cn);
1134     else
1135     {
1136         time_t cur_time = time(0);
1137         struct tm *tm =  localtime(&cur_time);
1138         char tmp_str[300];
1139         const char *cp = tmp_str;
1140
1141         /* see man strftime(3) for things .. In particular %% gets converted
1142          to %.. And That's our original query .. */
1143         strftime(tmp_str, sizeof(tmp_str)-1, pqf_strftime, tm);
1144         for (; *cp; cp++)
1145         {
1146             if (cp[0] == '%')
1147                 ccl_pquery(w_pqf, cn);
1148             else
1149                 wrbuf_putc(w_pqf, cp[0]);
1150         }
1151     }
1152     xfree(cl->pquery);
1153     cl->pquery = xstrdup(wrbuf_cstr(w_pqf));
1154     wrbuf_destroy(w_pqf);
1155
1156     yaz_log(YLOG_LOG, "PQF query: %s", cl->pquery);
1157
1158     xfree(cl->cqlquery);
1159
1160     /* Support for PQF on SRU targets. */
1161     /* TODO Refactor */
1162     yaz_log(YLOG_DEBUG, "Query syntax: %s", query_syntax);
1163     if (strcmp(query_syntax, "pqf") != 0 && *sru)
1164     {
1165         if (!strcmp(sru, "solr")) {
1166             if (!(cl->cqlquery = make_solrquery(cl)))
1167                 return -1;
1168         }
1169         else {
1170             if (!(cl->cqlquery = make_cqlquery(cl)))
1171                 return -1;
1172         }
1173     }
1174     else
1175         cl->cqlquery = 0;
1176
1177     /* TODO FIX Not thread safe */
1178     if (!se->relevance)
1179     {
1180         // Initialize relevance structure with query terms
1181         se->relevance = relevance_create_ccl(
1182             se->service->charsets, se->nmem, cn);
1183     }
1184
1185     ccl_rpn_delete(cn);
1186     return 0;
1187 }
1188
1189 void client_set_session(struct client *cl, struct session *se)
1190 {
1191     cl->session = se;
1192 }
1193
1194 int client_is_active(struct client *cl)
1195 {
1196     if (cl->connection && (cl->state == Client_Connecting ||
1197                            cl->state == Client_Working))
1198         return 1;
1199     return 0;
1200 }
1201
1202 int client_is_active_preferred(struct client *cl)
1203 {
1204     /* only count if this is a preferred target. */
1205     if (!cl->preferred)
1206         return 0;
1207     /* TODO No sure this the condition that Seb wants */
1208     if (cl->connection && (cl->state == Client_Connecting ||
1209                            cl->state == Client_Working))
1210         return 1;
1211     return 0;
1212 }
1213
1214 Odr_int client_get_hits(struct client *cl)
1215 {
1216     return cl->hits;
1217 }
1218
1219 int client_get_num_records(struct client *cl)
1220 {
1221     return cl->record_offset;
1222 }
1223
1224 void client_set_diagnostic(struct client *cl, int diagnostic)
1225 {
1226     cl->diagnostic = diagnostic;
1227 }
1228
1229 int client_get_diagnostic(struct client *cl)
1230 {
1231     return cl->diagnostic;
1232 }
1233
1234 const char * client_get_suggestions_xml(struct client *cl, WRBUF wrbuf)
1235 {
1236     /* int idx; */
1237     struct suggestions *suggestions = cl->suggestions;
1238
1239     if (!suggestions) {
1240         //yaz_log(YLOG_DEBUG, "No suggestions found");
1241         return "";
1242     }
1243     if (suggestions->passthrough) {
1244         yaz_log(YLOG_DEBUG, "Passthrough Suggestions: \n%s\n", suggestions->passthrough);
1245         return suggestions->passthrough;
1246     }
1247     if (suggestions->num == 0) {
1248         return "";
1249     }
1250     /*
1251     for (idx = 0; idx < suggestions->num; idx++) {
1252         wrbuf_printf(wrbuf, "<suggest term=\"%s\"", suggestions->suggest[idx]);
1253         if (suggestions->misspelled[idx] && suggestions->misspelled[idx]) {
1254             wrbuf_puts(wrbuf, suggestions->misspelled[idx]);
1255             wrbuf_puts(wrbuf, "</suggest>\n");
1256         }
1257         else
1258             wrbuf_puts(wrbuf, "/>\n");
1259     }
1260     */
1261     return wrbuf_cstr(wrbuf);
1262 }
1263
1264
1265 void client_set_database(struct client *cl, struct session_database *db)
1266 {
1267     cl->database = db;
1268 }
1269
1270 const char *client_get_id(struct client *cl)
1271 {
1272     return cl->id;
1273 }
1274
1275 void client_set_maxrecs(struct client *cl, int v)
1276 {
1277     cl->maxrecs = v;
1278 }
1279
1280 int client_get_maxrecs(struct client *cl)
1281 {
1282     return cl->maxrecs;
1283 }
1284
1285 void client_set_startrecs(struct client *cl, int v)
1286 {
1287     cl->startrecs = v;
1288 }
1289
1290 void client_set_preferred(struct client *cl, int v)
1291 {
1292     cl->preferred = v;
1293 }
1294
1295
1296 struct suggestions* client_suggestions_create(const char* suggestions_string)
1297 {
1298     int i;
1299     NMEM nmem;
1300     struct suggestions *suggestions;
1301     if (suggestions_string == 0)
1302         return 0;
1303     nmem = nmem_create();
1304     suggestions = nmem_malloc(nmem, sizeof(*suggestions));
1305     yaz_log(YLOG_DEBUG, "client target suggestions: %s", suggestions_string);
1306
1307     suggestions->nmem = nmem;
1308     suggestions->num = 0;
1309     suggestions->misspelled = 0;
1310     suggestions->suggest = 0;
1311     suggestions->passthrough = nmem_strdup_null(nmem, suggestions_string);
1312
1313     if (suggestions_string)
1314         nmem_strsplit_escape2(suggestions->nmem, "\n", suggestions_string, &suggestions->suggest,
1315                               &suggestions->num, 1, '\\', 0);
1316     /* Set up misspelled array */
1317     suggestions->misspelled = (char **) nmem_malloc(nmem, suggestions->num * sizeof(**suggestions->misspelled));
1318     /* replace = with \0 .. for each item */
1319     for (i = 0; i < suggestions->num; i++)
1320     {
1321         char *cp = strchr(suggestions->suggest[i], '=');
1322         if (cp) {
1323             *cp = '\0';
1324             suggestions->misspelled[i] = cp+1;
1325         }
1326     }
1327     return suggestions;
1328 }
1329
1330 static void client_suggestions_destroy(struct client *cl)
1331 {
1332     NMEM nmem = cl->suggestions->nmem;
1333     cl->suggestions = 0;
1334     nmem_destroy(nmem);
1335 }
1336
1337 /*
1338  * Local variables:
1339  * c-basic-offset: 4
1340  * c-file-style: "Stroustrup"
1341  * indent-tabs-mode: nil
1342  * End:
1343  * vim: shiftwidth=4 tabstop=8 expandtab
1344  */
1345