index/rankstatic.c

   1 /* $Id: rankstatic.c,v 1.10 2007-01-15 15:10:16 adam Exp $
   2    Copyright (C) 1995-2007
   3    Index Data ApS
   4
   5 This file is part of the Zebra server.
   6
   7 Zebra is free software; you can redistribute it and/or modify it under
   8 the terms of the GNU General Public License as published by the Free
   9 Software Foundation; either version 2, or (at your option) any later
  10 version.
  11
  12 Zebra is distributed in the hope that it will be useful, but WITHOUT ANY
  13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15 for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with this program; if not, write to the Free Software
  19 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  20
  21 */
  22
  23 #include <stdio.h>
  24 #include <assert.h>
  25 #include <limits.h>
  26 #ifdef WIN32
  27 #include <io.h>
  28 #endif
  29 #if HAVE_UNISTD_H
  30 #include <unistd.h>
  31 #endif
  32
  33 #include "index.h"
  34 #include "rank.h"
  35
  36 static int log_level = 0;
  37 static int log_initialized = 0;
  38
  39 struct rank_set_info {
  40     int no_rank_entries;
  41 };
  42
  43 /*
  44  * create: Creates/Initialises this rank handler. This routine is
  45  *  called exactly once. The routine returns the class_handle.
  46  */
  47 static void *create (ZebraHandle zh)
  48 {
  49     if (!log_initialized)
  50     {
  51         log_level = yaz_log_module_level("rankstatic");
  52         log_initialized = 1;
  53     }
  54     yaz_log(log_level, "rank-static create");
  55     return 0;
  56 }
  57
  58 /*
  59  * destroy: Destroys this rank handler. This routine is called
  60  *  when the handler is no longer needed - i.e. when the server
  61  *  dies. The class_handle was previously returned by create.
  62  */
  63 static void destroy (struct zebra_register *reg, void *class_handle)
  64 {
  65     yaz_log(log_level, "rank-static destroy");
  66 }
  67
  68
  69 /**
  70  * begin: Prepares beginning of "real" ranking. Called once for
  71  *  each result set. The returned handle is a "set handle" and
  72  *  will be used in each of the handlers below.
  73  */
  74 static void *begin (struct zebra_register *reg,
  75                     void *class_handle, RSET rset, NMEM nmem,
  76                     TERMID *terms, int numterms)
  77 {
  78     struct rank_set_info *si =
  79         (struct rank_set_info *) nmem_malloc (nmem, sizeof(*si));
  80     int i;
  81
  82     yaz_log(log_level, "rank-static begin");
  83     /* count how many terms are ranked (2=102 or similar) */
  84     si->no_rank_entries = 0;
  85     for (i = 0; i < numterms; i++)
  86     {
  87         struct ord_list *ol = terms[i]->ol;
  88
  89         yaz_log(log_level, "i=%d flags=%s '%s'", i,
  90                 terms[i]->flags, terms[i]->name );
  91
  92         for (; ol; ol = ol->next)
  93         {
  94             int index_type = 0;
  95             const char *db = 0;
  96             const char *string_index = 0;
  97             int set = -1;
  98             int use = -1;
  99
 100             zebraExplain_lookup_ord(reg->zei,
 101                                     ol->ord, &index_type, &db, &string_index);
 102
 103             if (string_index)
 104                 yaz_log(log_level, " ord=%d index_type=%c db=%s str-index=%s",
 105                     ol->ord, index_type, db, string_index);
 106             else
 107                 yaz_log(log_level, " ord=%d index_type=%c db=%s set=%d use=%d",
 108                     ol->ord, index_type, db, set, use);
 109         }
 110         if (!strncmp (terms[i]->flags, "rank,", 5))
 111             (si->no_rank_entries)++;
 112     }
 113     return si;
 114 }
 115
 116 /*
 117  * end: Terminates ranking process. Called after a result set
 118  *  has been ranked.
 119  */
 120 static void end (struct zebra_register *reg, void *set_handle)
 121 {
 122     yaz_log(log_level, "rank-static end");
 123 }
 124
 125
 126 /**
 127  * add: Called for each word occurence in a result set. This routine
 128  *  should be as fast as possible. This routine should "incrementally"
 129  *  update the score.
 130  */
 131 static void add (void *set_handle, int seqno, TERMID term)
 132 {
 133 }
 134
 135 /*
 136  * calc: Called for each document in a result. This handler should
 137  *  produce a score based on previous call(s) to the add handler. The
 138  *  score should be between 0 and 1000. If score cannot be obtained
 139  *  -1 should be returned.
 140  */
 141 static int calc (void *set_handle, zint sysno, zint staticrank,
 142                  int *stop_flag)
 143 {
 144     struct rank_set_info *si = (struct rank_set_info *) set_handle;
 145
 146     if (!si->no_rank_entries)
 147         return -1;   /* ranking not enabled for any terms */
 148
 149     /* if we set *stop_flag = 1, we stop processing (of result set list) */
 150     /* staticrank = 0 is highest, MAXINT lowest */
 151     if (staticrank >= INT_MAX)
 152         return 0;
 153     /* but score is reverse (logical) */
 154     return INT_MAX - CAST_ZINT_TO_INT(staticrank);
 155 }
 156
 157 /*
 158  * Pseudo-meta code with sequence of calls as they occur in a
 159  * server. Handlers are prefixed by --:
 160  *
 161  *     server init
 162  *     -- create
 163  *     foreach search
 164  *        rank result set
 165  *        -- begin
 166  *        foreach record
 167  *           foreach word
 168  *              -- add
 169  *           -- calc
 170  *        -- end
 171  *     -- destroy
 172  *     server close
 173  */
 174
 175 static struct rank_control rank_control = {
 176     "rank-static",
 177     create,
 178     destroy,
 179     begin,
 180     end,
 181     calc,
 182     add,
 183 };
 184
 185 struct rank_control *rank_static_class = &rank_control;
 186 /*
 187  * Local variables:
 188  * c-basic-offset: 4
 189  * indent-tabs-mode: nil
 190  * End:
 191  * vim: shiftwidth=4 tabstop=8 expandtab
 192  */
 193