common/omenquireinternal.h

Go to the documentation of this file.

/* omenquireinternal.h: Internals
 *
 * Copyright 1999,2000,2001 BrightStation PLC
 * Copyright 2001,2002 Ananova Ltd
 * Copyright 2002,2003,2004,2005,2006,2007 Olly Betts
 *
 * This program 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 of the
 * License, or (at your option) any later version.
 *
 * This program 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
 */

#ifndef OM_HGUARD_OMENQUIREINTERNAL_H
#define OM_HGUARD_OMENQUIREINTERNAL_H

#include <xapian/database.h>
#include <xapian/document.h>
#include <xapian/enquire.h>
#include <xapian/sorter.h>
#include <xapian/query.h>
#include <algorithm>
#include <math.h>
#include <map>
#include <set>

using namespace std;

class OmExpand;
class RSetI;
class MultiMatch;

namespace Xapian {

class ErrorHandler;
class TermIterator;

namespace Internal {

class ESetItem {
    public:
        ESetItem(Xapian::weight wt_, string tname_) : wt(wt_), tname(tname_) { }

        void swap(ESetItem & o) {
            std::swap(wt, o.wt);
            std::swap(tname, o.tname);
        }

        Xapian::weight wt;
        string tname;

        string get_description() const;
};

class MSetItem {
    public:
        MSetItem(Xapian::weight wt_, Xapian::docid did_)
                : wt(wt_), did(did_), collapse_count(0) {}

        MSetItem(Xapian::weight wt_, Xapian::docid did_, const string &key_)
                : wt(wt_), did(did_), collapse_key(key_), collapse_count(0) {}

        MSetItem(Xapian::weight wt_, Xapian::docid did_, const string &key_,
                 Xapian::doccount collapse_count_)
                : wt(wt_), did(did_), collapse_key(key_),
                  collapse_count(collapse_count_) {}

        void swap(MSetItem & o) {
            std::swap(wt, o.wt);
            std::swap(did, o.did);
            std::swap(collapse_key, o.collapse_key);
            std::swap(collapse_count, o.collapse_count);
            std::swap(sort_key, o.sort_key);
        }

        Xapian::weight wt;

        Xapian::docid did;

        string collapse_key;

        Xapian::doccount collapse_count;

        /* FIXME: why not just cache the Xapian::Document here!?! */
        string sort_key;

        string get_description() const;
};

}

class Enquire::Internal : public Xapian::Internal::RefCntBase {
    private:
        const Xapian::Database db;

        Query query;

        termcount qlen;

        Internal(const Internal &);
        void operator=(const Internal &);

    public:
        typedef enum { REL, VAL, VAL_REL, REL_VAL } sort_setting;

        Xapian::valueno collapse_key;

        Xapian::Enquire::docid_order order;

        percent percent_cutoff;

        Xapian::weight weight_cutoff;

        Xapian::valueno sort_key;
        sort_setting sort_by;
        bool sort_value_forward;

        Sorter * sorter;

        ErrorHandler * errorhandler;

        mutable Weight * weight; // mutable so get_mset can set default

        Internal(const Xapian::Database &databases, ErrorHandler * errorhandler_);
        ~Internal();

        void request_doc(const Xapian::Internal::MSetItem &item) const;

        Xapian::Document read_doc(const Xapian::Internal::MSetItem &item) const;

        void set_query(const Query & query_, termcount qlen_);
        const Query & get_query();
        MSet get_mset(Xapian::doccount first, Xapian::doccount maxitems,
                      Xapian::doccount check_at_least,
                      const RSet *omrset, const MatchDecider *mdecider,
                      const MatchDecider *matchspy) const;
        ESet get_eset(Xapian::termcount maxitems, const RSet & omrset, int flags,
                      double k, const ExpandDecider *edecider) const;

        TermIterator get_matching_terms(Xapian::docid did) const;
        TermIterator get_matching_terms(const Xapian::MSetIterator &it) const;

        void register_match_decider(const string &name,
                                    const MatchDecider *mdecider);

        string get_description() const;
};

class MSet::Internal : public Xapian::Internal::RefCntBase {
    public:
        double percent_factor;

    private:
        mutable set<Xapian::doccount> requested_docs;

        mutable map<Xapian::doccount, Xapian::Document> indexeddocs;

        void read_docs() const;

        Internal(const Internal &);
        void operator=(const Internal &);

    public:
        Xapian::Internal::RefCntPtr<const Enquire::Internal> enquire;

        struct TermFreqAndWeight {
            TermFreqAndWeight() { }
            TermFreqAndWeight(Xapian::doccount tf, Xapian::weight wt)
                : termfreq(tf), termweight(wt) { }
            Xapian::doccount termfreq;
            Xapian::weight termweight;
        };

        map<string, TermFreqAndWeight> termfreqandwts;

        vector<Xapian::Internal::MSetItem> items;

        Xapian::doccount firstitem;

        Xapian::doccount matches_lower_bound;

        Xapian::doccount matches_estimated;

        Xapian::doccount matches_upper_bound;

        Xapian::weight max_possible;

        Xapian::weight max_attained;

        Internal()
                : percent_factor(0),
                  firstitem(0),
                  matches_lower_bound(0),
                  matches_estimated(0),
                  matches_upper_bound(0),
                  max_possible(0),
                  max_attained(0) {}

        Internal(Xapian::doccount firstitem_,
             Xapian::doccount matches_upper_bound_,
             Xapian::doccount matches_lower_bound_,
             Xapian::doccount matches_estimated_,
             Xapian::weight max_possible_,
             Xapian::weight max_attained_,
             const vector<Xapian::Internal::MSetItem> &items_,
             const map<string, TermFreqAndWeight> &termfreqandwts_,
             Xapian::weight percent_factor_)
                : percent_factor(percent_factor_),
                  termfreqandwts(termfreqandwts_),
                  items(items_),
                  firstitem(firstitem_),
                  matches_lower_bound(matches_lower_bound_),
                  matches_estimated(matches_estimated_),
                  matches_upper_bound(matches_upper_bound_),
                  max_possible(max_possible_),
                  max_attained(max_attained_) {}

        Xapian::Document get_doc_by_index(Xapian::doccount index) const;

        percent convert_to_percent_internal(Xapian::weight wt) const;

        string get_description() const;

        void fetch_items(Xapian::doccount first, Xapian::doccount last) const;
};

class ESet::Internal : public Xapian::Internal::RefCntBase {
    friend class ESet;
    friend class ESetIterator;
    friend class ::OmExpand;
    private:
        vector<Xapian::Internal::ESetItem> items;

        Xapian::termcount ebound;

    public:
        Internal() : ebound(0) {}

        string get_description() const;
};

class RSet::Internal : public Xapian::Internal::RefCntBase {
    friend class Xapian::RSet;

    private:
        set<Xapian::docid> items;

    public:
        const set<Xapian::docid> & get_items() const { return items; }

        string get_description() const;
};

}

#endif // OM_HGUARD_OMENQUIREINTERNAL_H

---