rankstatic.c

Go to the documentation of this file.

/* This file is part of the Zebra server.
   Copyright (C) Index Data
 
Zebra is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option) any later
version.
 
Zebra is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.
 
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 
*/
 
#if HAVE_CONFIG_H
#include <config.h>
#endif
#include <stdio.h>
#include <assert.h>
#include <limits.h>
#ifdef WIN32
#include <io.h>
#endif
#if HAVE_UNISTD_H
#include <unistd.h>
#endif
 
#include "index.h"
#include "rank.h"
 
static int log_level = 0;
static int log_initialized = 0;
 
struct rank_set_info {
    int no_rank_entries;
};
 
/*
 * create: Creates/Initialises this rank handler. This routine is
 *  called exactly once. The routine returns the class_handle.
 */
static void *create (ZebraHandle zh)
{
    if (!log_initialized)
    {
        log_level = yaz_log_module_level("rankstatic");
        log_initialized = 1;
    }
    yaz_log(log_level, "rank-static create");
    return 0;
}
 
/*
 * destroy: Destroys this rank handler. This routine is called
 *  when the handler is no longer needed - i.e. when the server
 *  dies. The class_handle was previously returned by create.
 */
static void destroy (struct zebra_register *reg, void *class_handle)
{
    yaz_log(log_level, "rank-static destroy");
}
 
 
static void *begin (struct zebra_register *reg,
                    void *class_handle, RSET rset, NMEM nmem,
                    TERMID *terms, int numterms)
{
    struct rank_set_info *si =
        (struct rank_set_info *) nmem_malloc (nmem, sizeof(*si));
    int i;
 
    yaz_log(log_level, "rank-static begin");
    /* count how many terms are ranked (2=102 or similar) */
    si->no_rank_entries = 0;
    for (i = 0; i < numterms; i++)
    {
        struct ord_list *ol = terms[i]->ol;
 
        yaz_log(log_level, "i=%d flags=%s '%s'", i,
                terms[i]->flags, terms[i]->name );
 
        for (; ol; ol = ol->next)
        {
            const char *index_type = 0;
            const char *db = 0;
            const char *string_index = 0;
            int set = -1;
            int use = -1;
 
            zebraExplain_lookup_ord(reg->zei,
                                    ol->ord, &index_type, &db, &string_index);
 
            if (string_index)
                yaz_log(log_level, " ord=%d index_type=%s db=%s str-index=%s",
                        ol->ord, index_type, db, string_index);
            else
                yaz_log(log_level, " ord=%d index_type=%s db=%s set=%d use=%d",
                        ol->ord, index_type, db, set, use);
        }
        if (!strncmp (terms[i]->flags, "rank,", 5))
            (si->no_rank_entries)++;
    }
    return si;
}
 
/*
 * end: Terminates ranking process. Called after a result set
 *  has been ranked.
 */
static void end (struct zebra_register *reg, void *set_handle)
{
    yaz_log(log_level, "rank-static end");
}
 
 
static void add (void *set_handle, int seqno, TERMID term)
{
}
 
/*
 * calc: Called for each document in a result. This handler should
 *  produce a score based on previous call(s) to the add handler. The
 *  score should be between 0 and 1000. If score cannot be obtained
 *  -1 should be returned.
 */
static int calc (void *set_handle, zint sysno, zint staticrank,
                 int *stop_flag)
{
    struct rank_set_info *si = (struct rank_set_info *) set_handle;
 
    if (!si->no_rank_entries)
        return -1;   /* ranking not enabled for any terms */
 
    /* if we set *stop_flag = 1, we stop processing (of result set list) */
    /* staticrank = 0 is highest, MAXINT lowest */
    if (staticrank >= INT_MAX)
        return 0;
    /* but score is reverse (logical) */
    return INT_MAX - CAST_ZINT_TO_INT(staticrank);
}
 
/*
 * Pseudo-meta code with sequence of calls as they occur in a
 * server. Handlers are prefixed by --:
 *
 *     server init
 *     -- create
 *     foreach search
 *        rank result set
 *        -- begin
 *        foreach record
 *           foreach word
 *              -- add
 *           -- calc
 *        -- end
 *     -- destroy
 *     server close
 */
 
static struct rank_control rank_control = {
    "rank-static",
    create,
    destroy,
    begin,
    end,
    calc,
    add,
};
 
struct rank_control *rank_static_class = &rank_control;
/*
 * Local variables:
 * c-basic-offset: 4
 * c-file-style: "Stroustrup"
 * indent-tabs-mode: nil
 * End:
 * vim: shiftwidth=4 tabstop=8 expandtab
 */