1 /* This file is part of the YAZ toolkit.
2 * Copyright (C) Index Data
3 * See the file LICENSE for details.
7 * \brief Implements Solr decoding/encoding
16 #include <yaz/matchstr.h>
17 #include <yaz/yaz-iconv.h>
19 #include <yaz/facet.h>
20 #include <yaz/wrbuf.h>
21 #include <yaz/proto.h>
26 #include <libxml/parser.h>
27 #include <libxml/tree.h>
29 static void extract_text_node(xmlNodePtr node, WRBUF wrbuf)
32 for (child = node->children; child ; child = child->next)
34 if (child->type == XML_TEXT_NODE)
35 wrbuf_puts(wrbuf, (const char *) child->content);
39 static int match_xml_node_attribute(
41 const char *node_name, const char *attribute_name, const char *value)
43 const char *attribute_value;
44 // check if the node name matches
45 if (strcmp((const char*) ptr->name, node_name))
49 attribute_value = yaz_element_attribute_value_get(ptr, node_name,
51 if (attribute_value && !strcmp(attribute_value, value))
54 else /* No attribute to check */
59 static void yaz_solr_decode_result_docs(ODR o, xmlNodePtr ptr,
61 Z_SRW_searchRetrieveResponse *sr)
68 for (node = ptr->children; node; node = node->next)
69 if (node->type == XML_ELEMENT_NODE)
73 sr->records = odr_malloc(o, sizeof(*sr->records) * sr->num_records);
75 for (node = ptr->children; node; node = node->next)
77 if (node->type == XML_ELEMENT_NODE)
79 Z_SRW_record *record = sr->records + i;
80 xmlBufferPtr buf = xmlBufferCreate();
81 xmlNode *tmp = xmlCopyNode(node, 1);
83 xmlNodeDump(buf, tmp->doc, tmp, 0, 0);
87 record->recordSchema = 0;
88 record->recordPacking = Z_SRW_recordPacking_XML;
89 record->recordData_len = buf->use;
90 record->recordData_buf =
91 odr_strdupn(o, (const char *) buf->content, buf->use);
92 record->recordPosition = odr_intdup(o, start + offset + 1);
102 static int yaz_solr_decode_result(ODR o, xmlNodePtr ptr,
103 Z_SRW_searchRetrieveResponse *sr)
106 struct _xmlAttr *attr;
107 for (attr = ptr->properties; attr; attr = attr->next)
108 if (attr->children && attr->children->type == XML_TEXT_NODE)
110 if (!strcmp((const char *) attr->name, "numFound"))
112 sr->numberOfRecords = odr_intdup(o, odr_atoi(
113 (const char *) attr->children->content));
115 else if (!strcmp((const char *) attr->name, "start"))
117 start = odr_atoi((const char *) attr->children->content);
120 if (sr->numberOfRecords && *sr->numberOfRecords > 0)
121 yaz_solr_decode_result_docs(o, ptr, start, sr);
122 if (sr->numberOfRecords)
127 static const char *get_facet_term_count(xmlNodePtr node, Odr_int *freq)
129 const char *term = yaz_element_attribute_value_get(node, "int", "name");
131 WRBUF wrbuf = wrbuf_alloc();
135 for (child = node->children; child ; child = child->next)
137 if (child->type == XML_TEXT_NODE)
138 wrbuf_puts(wrbuf, (const char *) child->content);
140 *freq = odr_atoi(wrbuf_cstr(wrbuf));
141 wrbuf_destroy(wrbuf);
145 Z_FacetField *yaz_solr_decode_facet_field(ODR o, xmlNodePtr ptr,
146 Z_SRW_searchRetrieveResponse *sr)
149 Z_AttributeList *list;
150 Z_FacetField *facet_field;
155 const char* name = yaz_element_attribute_value_get(ptr, "lst", "name");
156 list = zget_AttributeList_use_string(o, name);
157 for (node = ptr->children; node; node = node->next)
159 facet_field = facet_field_create(o, list, num_terms);
161 for (node = ptr->children; node; node = node->next)
164 const char *term = get_facet_term_count(node, &count);
165 facet_field_term_set(o, facet_field,
166 facet_term_create_cstr(o, term, count), index);
172 static int yaz_solr_decode_facet_counts(ODR o, xmlNodePtr root,
173 Z_SRW_searchRetrieveResponse *sr)
176 for (ptr = root->children; ptr; ptr = ptr->next)
178 if (match_xml_node_attribute(ptr, "lst", "name", "facet_fields"))
181 Z_FacetList *facet_list;
183 for (node = ptr->children; node; node= node->next)
187 facet_list = facet_list_create(o, num_facets);
189 for (node = ptr->children; node; node= node->next)
191 facet_list_field_set(o, facet_list,
192 yaz_solr_decode_facet_field(o, node, sr),
196 sr->facetList = facet_list;
203 static void yaz_solr_decode_suggestion_values(xmlNodePtr listPptr, WRBUF wrbuf)
206 for (node = listPptr; node; node= node->next)
207 if (!strcmp((char*) node->name, "lst"))
210 for (child = node->children; child; child= child->next)
212 if (match_xml_node_attribute(child, "str", "name", "word"))
214 wrbuf_puts(wrbuf, "<suggestion>");
215 extract_text_node(child, wrbuf);
216 wrbuf_puts(wrbuf, "</suggestion>\n");
222 static void yaz_solr_decode_suggestion_lst(xmlNodePtr lstPtr, WRBUF wrbuf)
225 for (node = lstPtr; node; node= node->next)
226 if (match_xml_node_attribute(node, "arr", "name", "suggestion"))
227 yaz_solr_decode_suggestion_values(node->children, wrbuf);
230 static void yaz_solr_decode_misspelled(xmlNodePtr lstPtr, WRBUF wrbuf)
233 for (node = lstPtr; node; node= node->next)
235 if (!strcmp((const char*) node->name, "lst"))
237 const char *misspelled =
238 yaz_element_attribute_value_get(node, "lst", "name");
241 wrbuf_printf(wrbuf, "<misspelled term=\"%s\">\n", misspelled);
242 yaz_solr_decode_suggestion_lst(node->children, wrbuf);
243 wrbuf_puts(wrbuf, "</misspelled>\n");
249 static int yaz_solr_decode_spellcheck(ODR o, xmlNodePtr spellcheckPtr, Z_SRW_searchRetrieveResponse *sr)
252 WRBUF wrbuf = wrbuf_alloc();
253 wrbuf_puts(wrbuf, "");
254 for (ptr = spellcheckPtr->children; ptr; ptr = ptr->next)
256 if (match_xml_node_attribute(ptr, "lst", "name", "suggestions"))
258 yaz_solr_decode_misspelled(ptr->children, wrbuf);
261 sr->suggestions = odr_strdup(o, wrbuf_cstr(wrbuf));
265 static int yaz_solr_decode_scan_result(ODR o, xmlNodePtr ptr,
266 Z_SRW_scanResponse *scr)
272 /* find the actual list */
273 for (node = ptr->children; node; node = node->next)
274 if (node->type == XML_ELEMENT_NODE)
281 for (node = ptr->children; node; node = node->next)
282 if (node->type == XML_ELEMENT_NODE &&
283 !strcmp((const char *) node->name, "int"))
287 scr->terms = odr_malloc(o, sizeof(*scr->terms) * scr->num_terms);
289 for (node = ptr->children; node; node = node->next)
291 if (node->type == XML_ELEMENT_NODE &&
292 !strcmp((const char *) node->name, "int"))
294 Z_SRW_scanTerm *term = scr->terms + i;
297 const char *val = get_facet_term_count(node, &count);
299 term->numberOfRecords = odr_intdup(o, count);
301 /* if val contains a ^ then it is probably term<^>display term so separate them. This is due to
302 * SOLR not being able to encode them into 2 separate attributes.
304 pos = strchr(val, '^');
307 term->displayTerm = odr_strdup(o, pos + 1);
309 term->value = odr_strdup(o, val);
314 term->value = odr_strdup(o, val);
315 term->displayTerm = NULL;
317 term->whereInList = NULL;
328 int yaz_solr_decode_response(ODR o, Z_HTTP_Response *hres, Z_SRW_PDU **pdup)
333 const char *content_buf = hres->content_buf;
334 int content_len = hres->content_len;
335 xmlDocPtr doc = xmlParseMemory(content_buf, content_len);
339 Z_SRW_searchRetrieveResponse *sr = NULL;
340 Z_SRW_scanResponse *scr = NULL;
342 xmlNodePtr root = xmlDocGetRootElement(doc);
343 if (root && !strcmp((const char *) root->name, "response"))
345 for (ptr = root->children; ptr; ptr = ptr->next)
347 if (ptr->type == XML_ELEMENT_NODE &&
348 !strcmp((const char *) ptr->name, "result"))
350 pdu = yaz_srw_get(o, Z_SRW_searchRetrieve_response);
351 sr = pdu->u.response;
352 ret = yaz_solr_decode_result(o, ptr, sr);
355 if (ptr->type == XML_ELEMENT_NODE &&
356 match_xml_node_attribute(ptr, "lst", "name", "terms"))
358 pdu = yaz_srw_get(o, Z_SRW_scan_response);
359 scr = pdu->u.scan_response;
360 ret = yaz_solr_decode_scan_result(o, ptr, scr);
362 /* The check on hits is a work-around to avoid garbled
363 facets on zero results from the SOLR server.
364 The work-around works because the results is before
365 the facets in the xml.
367 if (sr && *sr->numberOfRecords > 0 &&
368 match_xml_node_attribute(ptr, "lst", "name",
370 ret = yaz_solr_decode_facet_counts(o, ptr, sr);
371 if (sr && *sr->numberOfRecords == 0 &&
372 match_xml_node_attribute(ptr, "lst", "name",
374 ret = yaz_solr_decode_spellcheck(o, ptr, sr);
384 static int yaz_solr_encode_facet_field(
385 ODR encode, char **name, char **value, int *i,
386 Z_FacetField *facet_field)
388 Z_AttributeList *attribute_list = facet_field->attributes;
389 struct yaz_facet_attr attr_values;
390 yaz_facet_attr_init(&attr_values);
391 yaz_facet_attr_get_z_attributes(attribute_list, &attr_values);
393 if (attr_values.errcode)
395 if (attr_values.useattr)
397 WRBUF wrbuf = wrbuf_alloc();
398 yaz_add_name_value_str(encode, name, value, i,
400 odr_strdup(encode, attr_values.useattr));
402 if (attr_values.limit > 0)
404 Odr_int v = attr_values.limit;
406 wrbuf_printf(wrbuf, "f.%s.facet.limit", attr_values.useattr);
407 yaz_add_name_value_int(encode, name, value, i,
408 odr_strdup(encode, wrbuf_cstr(wrbuf)),
411 if (attr_values.start > 1)
413 Odr_int v = attr_values.start - 1;
415 wrbuf_printf(wrbuf, "f.%s.facet.offset", attr_values.useattr);
416 yaz_add_name_value_int(encode, name, value, i,
417 odr_strdup(encode, wrbuf_cstr(wrbuf)),
420 if (attr_values.sortorder == 1)
423 wrbuf_printf(wrbuf, "f.%s.facet.sort", attr_values.useattr);
424 yaz_add_name_value_str(encode, name, value, i,
425 odr_strdup(encode, wrbuf_cstr(wrbuf)),
428 wrbuf_destroy(wrbuf);
432 if (attr_values.limit > 0)
434 Odr_int v = attr_values.limit;
435 yaz_add_name_value_int(encode, name, value, i, "facet.limit", &v);
437 if (attr_values.start > 1)
439 Odr_int v = attr_values.start - 1;
440 yaz_add_name_value_int(encode, name, value, i, "facet.offset", &v);
442 if (attr_values.sortorder == 1)
444 yaz_add_name_value_str(encode, name, value, i, "facet.sort",
451 static int yaz_solr_encode_facet_list(
452 ODR encode, char **name, char **value,
453 int *i, Z_FacetList *facet_list)
456 for (index = 0; index < facet_list->num; index++)
458 int r = yaz_solr_encode_facet_field(encode, name, value, i,
459 facet_list->elements[index]);
467 int yaz_solr_encode_request(Z_HTTP_Request *hreq, Z_SRW_PDU *srw_pdu,
468 ODR encode, const char *charset)
470 const char *solr_op = 0;
471 char **name, **value;
476 const char *path_args = 0;
479 int no_parms = 20; /* safe upper limit of args without extra_args */
482 if (srw_pdu->which == Z_SRW_searchRetrieve_request)
483 { /* to make room for facets in yaz_solr_encode_facet_list later */
484 Z_SRW_searchRetrieveRequest *request = srw_pdu->u.request;
485 if (request->facetList)
486 no_parms += request->facetList->num;
488 for (ea = srw_pdu->extra_args; ea; ea = ea->next)
490 name = (char **) odr_malloc(encode, sizeof(*name) * no_parms);
491 value = (char **) odr_malloc(encode, sizeof(*value) * no_parms);
493 for (ea = srw_pdu->extra_args; ea; ea = ea->next)
496 if (!strcmp(ea->name, "defType"))
498 value[i] = ea->value;
502 z_HTTP_header_add_basic_auth(encode, &hreq->headers,
503 srw_pdu->username, srw_pdu->password);
504 if (srw_pdu->which == Z_SRW_searchRetrieve_request)
506 Z_SRW_searchRetrieveRequest *request = srw_pdu->u.request;
508 if (!srw_pdu->u.request->query)
511 yaz_add_name_value_str(encode, name, value, &i, "defType",
513 yaz_add_name_value_str(encode, name, value, &i, "q", request->query);
514 if (srw_pdu->u.request->startRecord)
516 Odr_int start = *request->startRecord - 1;
517 yaz_add_name_value_int(encode, name, value, &i,
520 yaz_add_name_value_int(encode, name, value, &i,
521 "rows", request->maximumRecords);
522 yaz_add_name_value_str(encode, name, value, &i,
523 "fl", request->recordSchema);
525 switch(srw_pdu->u.request->sort_type)
527 case Z_SRW_sort_type_none:
529 case Z_SRW_sort_type_sort:
530 yaz_add_name_value_str(encode, name, value, &i, "sort",
531 srw_pdu->u.request->sort.sortKeys);
534 if (request->facetList)
536 Z_FacetList *facet_list = request->facetList;
537 yaz_add_name_value_str(encode, name, value, &i, "facet", "true");
538 yaz_add_name_value_str(encode, name, value, &i, "facet.mincount", "1");
539 if (yaz_solr_encode_facet_list(encode, name, value, &i, facet_list))
543 else if (srw_pdu->which == Z_SRW_scan_request)
545 Z_SRW_scanRequest *request = srw_pdu->u.scan_request;
547 if (!srw_pdu->u.scan_request->scanClause)
549 if (!strcmp(srw_pdu->u.scan_request->queryType, "pqf"))
551 yaz_add_name_value_str(encode, name, value, &i,
552 "terms.fl", request->scanClause);
553 yaz_add_name_value_str(encode, name, value, &i,
554 "terms.lower", request->scanClause);
556 else if (!strcmp(srw_pdu->u.scan_request->queryType, "cql"))
558 q = request->scanClause;
562 yaz_add_name_value_str(encode, name, value, &i,
563 "terms.lower", odr_strdup(encode, cp + 1));
565 yaz_add_name_value_str(encode, name, value, &i,
566 "terms.fl", odr_strdup(encode, q));
570 yaz_add_name_value_str(encode, name, value, &i,
571 "terms.lower", odr_strdup(encode, q));
575 yaz_add_name_value_str(encode, name, value, &i,
576 "terms.sort", "index");
577 yaz_add_name_value_int(encode, name, value, &i,
578 "terms.limit", request->maximumTerms);
585 yaz_array_to_uri(&uri_args, encode, name, value);
587 hreq->method = "GET";
590 odr_malloc(encode, strlen(hreq->path) +
591 strlen(uri_args) + strlen(solr_op) + 5);
593 cp = strchr(hreq->path, '#');
596 cp = strchr(hreq->path, '?');
599 *cp = '\0'; /* args in path */
602 strcpy(path, hreq->path);
603 cp = strrchr(path, '/');
606 if (!strcmp(cp, "/select") || !strcmp(cp, "/"))
610 strcat(path, solr_op);
614 strcat(path, path_args);
617 strcat(path, uri_args);
626 * c-file-style: "Stroustrup"
627 * indent-tabs-mode: nil
629 * vim: shiftwidth=4 tabstop=8 expandtab