summaryrefslogtreecommitdiff
path: root/indra/llmessage/llexperiencecache.h
blob: 396a24493535435f6ab0f6c7dcb5053f7f9868c9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
/** 
 * @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