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