RetroShare/libretroshare/src/services/p3ranking.h

/*
 * libretroshare/src/services: p3ranking.h
 *
 * 3P/PQI network interface for RetroShare.
 *
 * Copyright 2007-2008 by Robert Fernie.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License Version 2 as published by the Free Software Foundation.
 *
 * This library 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
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
 * USA.
 *
 * Please report all bugs and problems to "retroshare@lunamutt.com".
 *
 */

#ifndef P3_GENERIC_RANKING_HEADER
#define P3_GENERIC_RANKING_HEADER

#include "dbase/cachestrapper.h"
#include "pqi/pqiservice.h"
#include "pqi/pqistreamer.h"
//#include "util/rsthreads.h"

#include "serialiser/rsserial.h"

#include "rsiface/rsrank.h"

/* 
 * A Generic Ranking system.
 * Each User provides one cache...
 *
 * can be overloaded for specific types
 * (links, shares, photos etc)
 */

class RsRankMsg: public RsItem
{
	public:

	//std::string peerId; /* From */
	std::string rid; /* Random Id */
	time_t      timestamp;
	std::wstring link;
	std::wstring title;
	std::wstring comment;

	RsRankMsg():RsItem(0) { return; }
virtual void clear() 
	{ return; }
virtual std::ostream& print(std::ostream &out, uint16_t) 
	{ return out; }

};

class RsRankSerial: public RsSerialType
{
	public:

	RsRankSerial()
	:RsSerialType(0,0,0)
	{ return; }

};

/* group these together */

class RankGroup
{
	public:

	std::string rid; /* Random Id */
	std::wstring link; 
	std::wstring title; 
	float rank;
	bool ownTag;
	std::map<std::string, RsRankMsg *>  comments;
};


class p3Ranking: public CacheSource, public CacheStore
{
	public:

	p3Ranking(uint16_t subtype, CacheTransfer *cft,
		std::string sourcedir, std::string storedir, 
		uint32_t storePeriod);

/******************************* CACHE SOURCE / STORE Interface *********************/

	/* overloaded functions from Cache Source */
virtual bool    loadLocalCache(const CacheData &data);

	/* overloaded functions from Cache Store */
virtual int    loadCache(const CacheData &data);

/******************************* CACHE SOURCE / STORE Interface *********************/

	public:

/************* Extern Interface *******/

        /* Set Sort Methods */
virtual bool setSortPeriod(uint32_t period);
virtual bool setSortMethod(uint32_t type);
virtual bool clearPeerFilter();
virtual bool setPeerFilter(std::list<std::string> peers);

        /* get Ids */
virtual uint32_t getRankingsCount();
virtual float   getMaxRank();
virtual bool    getRankings(uint32_t first, uint32_t count, std::list<std::string> &rids);
virtual bool    getRankDetails(std::string rid, RsRankDetails &details);

        /* Add New Comment / Msg */
virtual std::string newRankMsg(std::wstring link, std::wstring title, std::wstring comment);
virtual bool updateComment(std::string rid, std::wstring comment);


void	tick();

void	loadRankFile(std::string filename, std::string src);
void 	addRankMsg(RsRankMsg *msg);
void 	publishMsgs();
float 	locked_calcRank(RankGroup &grp); /* returns 0->100 */
void	reSortGroup(RankGroup &grp);
void	sortAllMsgs();
pqistreamer *createStreamer(std::string file, std::string src, uint32_t bioflags);

	private:	

void	createDummyData();

	bool mRepublish;
	uint32_t mStorePeriod;

	std::string mOwnId;

	std::map<std::string, RankGroup> mData;
	std::multimap<float, std::string> mRankings;

	/* Filter/Sort params */
	std::list<std::string> mPeerFilter;
	uint32_t mViewPeriod;
	uint32_t mSortType;

};

#endif