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