include/yaz/srw.h

   1 /*
   2  * Copyright (c) 2002-2003, Index Data.
   3  * See the file LICENSE for details.
   4  *
   5  * $Id: srw.h,v 1.10 2003-12-29 14:54:33 adam Exp $
   6  */
   7
   8 #ifndef YAZ_SRW_H
   9 #define YAZ_SRW_H
  10
  11 #include <yaz/soap.h>
  12 #include <yaz/zgdu.h>
  13
  14 YAZ_BEGIN_CDECL
  15
  16 typedef struct {
  17     char *recordSchema;
  18     int recordPacking;
  19 #define Z_SRW_recordPacking_string 0
  20 #define Z_SRW_recordPacking_XML 1
  21     char *recordData_buf;
  22     int recordData_len;
  23     int *recordPosition;
  24 } Z_SRW_record;
  25
  26 typedef struct {
  27     int  *code;
  28     char *details;
  29 } Z_SRW_diagnostic;
  30
  31 typedef struct {
  32
  33 #define Z_SRW_query_type_cql  1
  34 #define Z_SRW_query_type_xcql 2
  35 #define Z_SRW_query_type_pqf  3
  36     int query_type;
  37     union {
  38         char *cql;
  39         char *xcql;
  40         char *pqf;
  41     } query;
  42
  43 #define Z_SRW_sort_type_none 1
  44 #define Z_SRW_sort_type_sort 2
  45 #define Z_SRW_sort_type_xSort 3
  46     int sort_type;
  47     union {
  48         char *none;
  49         char *sortKeys;
  50         char *xSortKeys;
  51     } sort;
  52     int *startRecord;
  53     int *maximumRecords;
  54     char *recordSchema;
  55     char *recordPacking;
  56     char *recordXPath;
  57     char *database;
  58     char *stylesheet;
  59     int *resultSetTTL;
  60 } Z_SRW_searchRetrieveRequest;
  61
  62 typedef struct {
  63     int * numberOfRecords;
  64     char * resultSetId;
  65     int * resultSetIdleTime;
  66
  67     Z_SRW_record *records;
  68     int num_records;
  69
  70     Z_SRW_diagnostic *diagnostics;
  71     int num_diagnostics;
  72     int *nextRecordPosition;
  73 } Z_SRW_searchRetrieveResponse;
  74
  75 typedef struct {
  76     char *recordPacking;
  77     char *database;
  78 } Z_SRW_explainRequest;
  79
  80 typedef struct {
  81     Z_SRW_record record;
  82     Z_SRW_diagnostic *diagnostics;
  83     int num_diagnostics;
  84 } Z_SRW_explainResponse;
  85
  86 typedef struct {
  87     char *scanClause;
  88     int *responsePosition;
  89     int *maximumTerms;
  90     char *stylesheet;
  91     char *database;
  92 } Z_SRW_scanRequest;
  93
  94 typedef struct {
  95     char *value;
  96     int *numberOfRecords;
  97     char *displayTerm;
  98 } Z_SRW_scanTerm;
  99
 100 typedef struct {
 101     Z_SRW_scanTerm *terms;
 102     int num_terms;
 103     Z_SRW_diagnostic *diagnostics;
 104     int num_diagnostics;
 105 } Z_SRW_scanResponse;
 106
 107 #define Z_SRW_searchRetrieve_request  1
 108 #define Z_SRW_searchRetrieve_response 2
 109 #define Z_SRW_explain_request 3
 110 #define Z_SRW_explain_response 4
 111 #define Z_SRW_scan_request 5
 112 #define Z_SRW_scan_response 6
 113
 114 typedef struct {
 115     int which;
 116     union {
 117         Z_SRW_searchRetrieveRequest *request;
 118         Z_SRW_searchRetrieveResponse *response;
 119         Z_SRW_explainRequest *explain_request;
 120         Z_SRW_explainResponse *explain_response;
 121         Z_SRW_scanRequest *scan_request;
 122         Z_SRW_scanResponse *scan_response;
 123     } u;
 124     char *srw_version;
 125 } Z_SRW_PDU;
 126
 127 YAZ_EXPORT int yaz_srw_codec(ODR o, void * pptr,
 128                              Z_SRW_PDU **handler_data,
 129                              void *client_data, const char *ns);
 130 YAZ_EXPORT Z_SRW_PDU *yaz_srw_get(ODR o, int which);
 131
 132 YAZ_EXPORT const char *yaz_diag_srw_str (int code);
 133
 134 YAZ_EXPORT int yaz_diag_bib1_to_srw (int bib1_code);
 135
 136 YAZ_EXPORT int yaz_diag_srw_to_bib1(int srw_code);
 137
 138 YAZ_EXPORT char *yaz_uri_val(const char *path, const char *name, ODR o);
 139 YAZ_EXPORT void yaz_uri_val_int(const char *path, const char *name,
 140                                 ODR o, int **intp);
 141 YAZ_EXPORT int yaz_check_for_srw(Z_HTTP_Request *hreq, Z_SRW_PDU **srw_pdu,
 142                                  char **soap_ns, ODR decode);
 143 YAZ_EXPORT int yaz_check_for_sru(Z_HTTP_Request *hreq, Z_SRW_PDU **srw_pdu,
 144                                  char **soap_ns, ODR decode);
 145 YAZ_END_CDECL
 146
 147 #endif