/** 
 * @file llexperiencecache.h
 * @brief Caches information relating to experience keys
 *
 * $LicenseInfo:firstyear=2012&license=viewerlgpl$
 * Second Life Viewer Source Code
 * Copyright (C) 2012, Linden Research, Inc.
 * 
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation;
 * version 2.1 of the License only.
 * 
 * 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
 * Lesser General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 * 
 * Linden Research, Inc., 945 Battery Street, San Francisco, CA  94111  USA
 * $/LicenseInfo$
 */



#ifndef LL_LLEXPERIENCECACHE_H
#define LL_LLEXPERIENCECACHE_H

#include "linden_common.h"
#include <boost/signals2.hpp>

class LLSD;
class LLUUID;



namespace LLExperienceCache
{
	const std::string PUBLIC_KEY	= "public-id";
	const std::string PRIVATE_KEY	= "private-id";
	const std::string CREATOR_KEY	= "creator-id";
	const std::string NAME			= "name";
	const std::string PROPERTIES	= "properties";
	const std::string EXPIRES		= "expires";  

	const int EXPERIENCE_INVALID    = (1 << 0);
	const int EXPERIENCE_NORMAL     = (1 << 1);
	const int EXPERIENCE_REGION     = (1 << 2);
	const static F64 DEFAULT_EXPIRATION = 600.0;

	// dummy name used when we have nothing else
	const std::string DUMMY_NAME = "\?\?\?";
	// Callback types for get() below
	typedef boost::signals2::signal<void (const LLSD& experience)>
		callback_signal_t;
	typedef callback_signal_t::slot_type callback_slot_t;
	typedef std::map<LLUUID, LLSD> cache_t;


	void setLookupURL(const std::string& lookup_url);
	bool hasLookupURL();

	void setMaximumLookups(int maximumLookups);

	void idle();
	void exportFile(std::ostream& ostr);
	void importFile(std::istream& istr);
	void initClass();
	
	void erase(const LLUUID& key, const std::string& key_type);
	bool fetch(const LLUUID& key, const std::string& key_type, bool refresh = false);
	void insert(LLSD& experience_data);
	bool get(const LLUUID& key, const std::string& key_type, LLSD& experience_data);

	// If name information is in cache, callback will be called immediately.
	void get(const LLUUID& key, const std::string& key_type, callback_slot_t slot);

	const cache_t& getCached();
};

#endif // LL_LLEXPERIENCECACHE_H