WebSVN – gelsvn – Diff – /trunk/src/Util/ResourceManager.h


#ifndef __RESOURCE_MANAGER_H
#define __RESOURCE_MANAGER_H
 
#include <cassert>
#include <string>
#include <list>
#include <typeinfo>
 
#define CLEAN_SHUTDOWN 1
 
namespace Util
{
 
	typedef unsigned char FlagByte;
	const FlagByte REMOVE_WHEN_UNUSED = 0x01;
	const FlagByte STATIC_RESOURCE    = 0x02;
 
	/** \brief This class template represents a resource record. 
 
	    There is a pointer to 
			the actual resource (of type RES) and a usage counter which should never
			be less than 0. */
	template<class RES>
	class ResourceRecord
	{
		/// Name of the resource (const)
    const std::string name;
 
		/// A pointer to the resource (the pointer not the pointee is const)
		RES * const res;
		
		/// Usage counter.
		int usage;
 
		/// Flags
		FlagByte flags;
 
	public:
	
		/// Construct a null record.
		ResourceRecord(): res(0), usage(0), flags(0) {}
 
		/// Construct a resource record with a name and a pointer.
		ResourceRecord(const std::string& _name, RES* _res, bool static_res=false): 
			name(_name), 
			res(_res), 
			usage(0), 
			flags(static_res ? STATIC_RESOURCE : 0) 
		{
			assert(res != 0);
		}
 
		~ResourceRecord() 
		{
#if CLEAN_SHUTDOWN
			assert(usage==0);		
#endif
		}
	
		void erase_resource()
		{
			assert(usage==0);
			if(!(flags&STATIC_RESOURCE)) 
				{
					delete res;
				}
		}
 
		/// Increment the usage counter
		void increment_usage() 
		{
			assert(usage>=0);
			++usage;
		}
 
		/// Decrement the usage counter. assert that counter is >0
		void decrement_usage() 
		{
			assert(usage>0);
			--usage;
		}
 
		/// Return the usage count (mostly for debugging)
		int get_usage() const { return usage; }
 
		/// Get the name of a resource
		const std::string& get_name() const {return name;}
 
		/// Get a pointer to the resource (const pointer)
		RES * const get_ptr() 
		{
			return res;
		}
 
		/// Get a resource pointer (const pointer and pointee)
		const RES * const get_ptr() const 
		{
			return res;
		}
 
		void remove_when_unused() 
		{
/* 			assert(!(flags&STATIC_RESOURCE)); */
/* 			if(!(flags&STATIC_RESOURCE)) */
				flags = flags|REMOVE_WHEN_UNUSED;
		}
 
		FlagByte get_flags() const { return flags;}
	
	};
 
 
	template<class RES> class ResourceManager;
 
 
	/** \brief Template for a pointer to a reference counted resource.
 
      The ResourcePtr class template is a template for a reference
			counted resource pointer. It is a smart pointer that actually points
			to a ResourceRecord and not to the actual resource. Since the record
			contains a reference count, we can increase the reference count when
			the pointer is copied and decrease it in the destructor. Only the
			ResourceManager can create ResourcePtr's directly from a raw
			ResourceRecord. */
	template<class RES>
	class ResourcePtr
	{
		typedef ResourceRecord<RES> RR;
		typedef std::list<RR> RRList;
		typedef typename RRList::iterator RRListIter;
 
		static RRListIter get_null_rrlist_iter()
		{
			static RRList l;
			return l.end();
		}
 
#define NULL_RRLIST_ITER ResourcePtr<RES>::get_null_rrlist_iter() 		
 
		friend class ResourceManager<RES>;
 
	private:		
		RRListIter rr;
		RES* res;
	
		/** Explicit constructor with value. The constructor can only be called
				by a friend, i.e. the resource manager. */
		explicit ResourcePtr(const RRListIter& _rr): rr(_rr), res(0)
		{
			if(rr != NULL_RRLIST_ITER)
				{
					rr->increment_usage();
					res = rr->get_ptr();
				}
		}
 
		void decrement_usage();
	
	public:
	
		ResourcePtr(): rr(NULL_RRLIST_ITER), res(0) {}
	
		ResourcePtr(const ResourcePtr& r2): rr(r2.rr), res(0)
		{
			if(rr != NULL_RRLIST_ITER)
				{
					rr->increment_usage();
					res = rr->get_ptr();
				}
		}
 
		const ResourcePtr& operator=(const ResourcePtr& r2) 
		{
			// Guard against self-assignment
			if (r2.rr != this->rr)
				{
					if(rr != NULL_RRLIST_ITER)	decrement_usage();
 
					rr  = r2.rr;
					res = 0;
 
					if(rr != NULL_RRLIST_ITER)
						{
							res = rr->get_ptr();
							rr->increment_usage();
						}
				}
			return *this;
		}
 
		~ResourcePtr() {decrement_usage();}
 
		RES& operator*() const 
		{
			assert(rr != NULL_RRLIST_ITER);
			assert(res != 0);
			return *res;
		}
 
		RES* const operator->() const 
		{
			assert(rr != NULL_RRLIST_ITER);
			assert(res !=0);
			return res;
		}
 
		RES* const get_raw_ptr() const 
		{
			assert(rr != NULL_RRLIST_ITER);
			assert(res != 0);
			return res;
		}
 
		int usage() const
		{
			if(rr != NULL_RRLIST_ITER)
				return rr->get_usage();
			return -1;
		}
 
		bool is_valid() const {return rr != NULL_RRLIST_ITER;}
 
		void relinquish_resource()
		{
			ResourcePtr p;
			*this = p;
		}
 
		/** Calling this function sets the REMOVE_WHEN_UNUSED flag. If this 
				flag is set, the resource record is removed from the manager */
		void remove_when_unused() {	rr->remove_when_unused(); }
	};
 
 
	/** \brief Resource manager class.
 
      The ResourceManager is a singleton, and it uses Scott Meyers construct
			on first use idiom, i.e. the static function get_instance() will
			construct it when first called. There may be a problem with this
			idion if resources depend on each other. However, that is only
			when the program shuts down.  See modern C++ design by
			Alexandrescu for more information.
 
			I'll try to make everything in this class private and accessed
			by a simple interface of friend functions.
 
	*/
 
	template<class RES>
	class ResourceManager
	{
		typedef ResourceRecord<RES> RR;
		typedef std::list<RR> RRList;
		typedef typename RRList::iterator RRListIter;
		RRList resources;
	
		ResourceManager(): resources(0) {}
		ResourceManager(const ResourceManager&);
		ResourceManager& operator=(const ResourceManager&);
 
	public:
 
 
		~ResourceManager()
		{
#if CLEAN_SHUTDOWN
			RRListIter i = resources.begin(); 
			while(i != resources.end())
				{
					if(i->get_usage()==0)
						{
							RRListIter tmp = i;
							++i;
							erase_resource(tmp);
						}
					else
						{
							std::cout << "Warning, ResourceManager:\n\n"
												<< (typeid(this).name())
												<< "\n\nis shutting down, and resource \n\n" 
												<< i->get_name() << "\n\nhas usage: " << i->get_usage()
												<< std::endl;
							std::cout <<
 								"In other words, this resource is not unused at this\n"
								"point. That is unfortunate because then it cannot\n"
								"be deleted (since it might be used by some other\n"
								"part of the program during shutdown). Please ensure\n"
								"that all resources are unused at program\n"
								"termination. If you use a global ResourcePtr, this is\n"
								"done by calling relinquish_resource just before\n"
								"exiting.\n"
												<< std::endl;
							++i;
						}
				}
#endif
		}
 
		int get_no_resources() const
		{
			return resources.size();
		}
 
		static ResourceManager& get_instance() 
		{
			static ResourceManager instance;
			return instance;
		}
 
		void erase_resource(RRListIter iter)
		{
			iter->erase_resource();
			resources.erase(iter);
		}
 
		/** Find a resource and return a ResourcePtr to it. Returns the 
				0 ResourcePtr if no string found. */
		ResourcePtr<RES> get_resource_ptr(const std::string& str)
		{
			for(RRListIter i = resources.begin(); i != resources.end(); ++i)
				if((*i).get_name() == str) 
					return ResourcePtr<RES>(i);
			return ResourcePtr<RES>(NULL_RRLIST_ITER);
		}
 
		/** Add a resource with name passed as first argument and a pointer
				passed as 2nd argument. A ResourcePtr to the just inserted
				element is returned. */
		ResourcePtr<RES> register_resource(const std::string& str, 
																			 RES* res, bool static_resource)
		{
			for(RRListIter i = resources.begin(); i != resources.end(); ++i)
				if(i->get_name() == str)
					return (ResourcePtr<RES>(NULL_RRLIST_ITER));
 
			resources.push_front(RR(str, res, static_resource));
			ResourcePtr<RES> ptr = ResourcePtr<RES>(resources.begin());
			return ptr;
		}
 
/*		friend class ResourcePtr<RES>;
		friend int get_no_resources<RES>();
		friend ResourcePtr<RES> get_resource_ptr<RES>(const std::string& str); 
		friend ResourcePtr<RES> register_static_resource<RES>(const std::string&,
																													RES*); 
		friend ResourcePtr<RES> register_dynamic_resource<RES>(const std::string&,
																													 RES*);*/ 
	};
 
	template<class RES>
	inline void ResourcePtr<RES>::decrement_usage()
	{
		assert( (rr == NULL_RRLIST_ITER) || (res != 0));
		if(rr != NULL_RRLIST_ITER)
			{
				rr->decrement_usage();
				if(rr->get_usage() == 0 && (rr->get_flags()&REMOVE_WHEN_UNUSED))
					{
						ResourceManager<RES>& man = ResourceManager<RES>::get_instance();
						man.erase_resource(rr);
					}
			}
	}
 
	template<class RES>
	inline int get_no_resources()
	{
		ResourceManager<RES>& man = ResourceManager<RES>::get_instance();
		return man.get_no_resources();
	}
 
	template<class RES>
	inline ResourcePtr<RES> get_resource_ptr(const std::string& str)
	{
		ResourceManager<RES>& man = ResourceManager<RES>::get_instance();
		return man.get_resource_ptr(str);
	}
 
	template<class RES>
	inline ResourcePtr<RES> register_dynamic_resource(const std::string& str,RES* res)
	{
		ResourceManager<RES>& man = ResourceManager<RES>::get_instance();
		ResourcePtr<RES> ptr = man.register_resource(str, res, false);
		return ptr;
	}
 
	template<class RES>
	inline ResourcePtr<RES> register_static_resource(const std::string& str,RES* res)
	{
		ResourceManager<RES>& man = ResourceManager<RES>::get_instance();
		ResourcePtr<RES> ptr = man.register_resource(str, res, true);
		return ptr;
	}
 
}
 
 
#endif
 

Rev 89	Rev 129
1	`#ifndef __RESOURCE_MANAGER_H`	1	`#ifndef __RESOURCE_MANAGER_H`
2	`#define __RESOURCE_MANAGER_H`	2	`#define __RESOURCE_MANAGER_H`
3		3
4	`#include <cassert>`	4	`#include <cassert>`
5	`#include <string>`	5	`#include <string>`
6	`#include <list>`	6	`#include <list>`
7	`#include <typeinfo>`	7	`#include <typeinfo>`
8		8
9	`#define CLEAN_SHUTDOWN 1`	9	`#define CLEAN_SHUTDOWN 1`
10		10
11	`namespace Util`	11	`namespace Util`
12	`{`	12	`{`
13		13
14	`typedef unsigned char FlagByte;`	14	`typedef unsigned char FlagByte;`
15	`const FlagByte REMOVE_WHEN_UNUSED = 0x01;`	15	`const FlagByte REMOVE_WHEN_UNUSED = 0x01;`
16	`const FlagByte STATIC_RESOURCE = 0x02;`	16	`const FlagByte STATIC_RESOURCE = 0x02;`
17		17
18	`/** \brief This class template represents a resource record.`	18	`/** \brief This class template represents a resource record.`
19		19
20	`There is a pointer to`	20	`There is a pointer to`
21	`the actual resource (of type RES) and a usage counter which should never`	21	`the actual resource (of type RES) and a usage counter which should never`
22	`be less than 0. */`	22	`be less than 0. */`
23	`template<class RES>`	23	`template<class RES>`
24	`class ResourceRecord`	24	`class ResourceRecord`
25	`{`	25	`{`
26	`/// Name of the resource (const)`	26	`/// Name of the resource (const)`
27	`const std::string name;`	27	`const std::string name;`
28		28
29	`/// A pointer to the resource (the pointer not the pointee is const)`	29	`/// A pointer to the resource (the pointer not the pointee is const)`
30	`RES * const res;`	30	`RES * const res;`
31		31
32	`/// Usage counter.`	32	`/// Usage counter.`
33	`int usage;`	33	`int usage;`
34		34
35	`/// Flags`	35	`/// Flags`
36	`FlagByte flags;`	36	`FlagByte flags;`
37		37
38	`public:`	38	`public:`
39		39
40	`/// Construct a null record.`	40	`/// Construct a null record.`
41	`ResourceRecord(): res(0), usage(0), flags(0) {}`	41	`ResourceRecord(): res(0), usage(0), flags(0) {}`
42		42
43	`/// Construct a resource record with a name and a pointer.`	43	`/// Construct a resource record with a name and a pointer.`
44	`ResourceRecord(const std::string& _name, RES* _res, bool static_res=false):`	44	`ResourceRecord(const std::string& _name, RES* _res, bool static_res=false):`
45	`name(_name),`	45	`name(_name),`
46	`res(_res),`	46	`res(_res),`
47	`usage(0),`	47	`usage(0),`
48	`flags(static_res ? STATIC_RESOURCE : 0)`	48	`flags(static_res ? STATIC_RESOURCE : 0)`
49	`{`	49	`{`
50	`assert(res != 0);`	50	`assert(res != 0);`
51	`}`	51	`}`
52		52
53	`~ResourceRecord()`	53	`~ResourceRecord()`
54	`{`	54	`{`
55	`#if CLEAN_SHUTDOWN`	55	`#if CLEAN_SHUTDOWN`
56	`assert(usage==0);`	56	`assert(usage==0);`
57	`#endif`	57	`#endif`
58	`}`	58	`}`
59		59
60	`void erase_resource()`	60	`void erase_resource()`
61	`{`	61	`{`
62	`assert(usage==0);`	62	`assert(usage==0);`
63	`if(!(flags&STATIC_RESOURCE))`	63	`if(!(flags&STATIC_RESOURCE))`
64	`{`	64	`{`
65	`delete res;`	65	`delete res;`
66	`}`	66	`}`
67	`}`	67	`}`
68		68
69	`/// Increment the usage counter`	69	`/// Increment the usage counter`
70	`void increment_usage()`	70	`void increment_usage()`
71	`{`	71	`{`
72	`assert(usage>=0);`	72	`assert(usage>=0);`
73	`++usage;`	73	`++usage;`
74	`}`	74	`}`
75		75
76	`/// Decrement the usage counter. assert that counter is >0`	76	`/// Decrement the usage counter. assert that counter is >0`
77	`void decrement_usage()`	77	`void decrement_usage()`
78	`{`	78	`{`
79	`assert(usage>0);`	79	`assert(usage>0);`
80	`--usage;`	80	`--usage;`
81	`}`	81	`}`
82		82
83	`/// Return the usage count (mostly for debugging)`	83	`/// Return the usage count (mostly for debugging)`
84	`int get_usage() const { return usage; }`	84	`int get_usage() const { return usage; }`
85		85
86	`/// Get the name of a resource`	86	`/// Get the name of a resource`
87	`const std::string& get_name() const {return name;}`	87	`const std::string& get_name() const {return name;}`
88		88
89	`/// Get a pointer to the resource (const pointer)`	89	`/// Get a pointer to the resource (const pointer)`
90	`RES * const get_ptr()`	90	`RES * const get_ptr()`
91	`{`	91	`{`
92	`return res;`	92	`return res;`
93	`}`	93	`}`
94		94
95	`/// Get a resource pointer (const pointer and pointee)`	95	`/// Get a resource pointer (const pointer and pointee)`
96	`const RES * const get_ptr() const`	96	`const RES * const get_ptr() const`
97	`{`	97	`{`
98	`return res;`	98	`return res;`
99	`}`	99	`}`
100		100
101	`void remove_when_unused()`	101	`void remove_when_unused()`
102	`{`	102	`{`
103	`/* assert(!(flags&STATIC_RESOURCE)); */`	103	`/* assert(!(flags&STATIC_RESOURCE)); */`
104	`/* if(!(flags&STATIC_RESOURCE)) */`	104	`/* if(!(flags&STATIC_RESOURCE)) */`
105	`flags = flags\|REMOVE_WHEN_UNUSED;`	105	`flags = flags\|REMOVE_WHEN_UNUSED;`
106	`}`	106	`}`
107		107
108	`FlagByte get_flags() const { return flags;}`	108	`FlagByte get_flags() const { return flags;}`
109		109
110	`};`	110	`};`
111		111
112		112
113	`template<class RES> class ResourceManager;`	113	`template<class RES> class ResourceManager;`
114		114
115		115
116	`/** \brief Template for a pointer to a reference counted resource.`	116	`/** \brief Template for a pointer to a reference counted resource.`
117		117
118	`The ResourcePtr class template is a template for a reference`	118	`The ResourcePtr class template is a template for a reference`
119	`counted resource pointer. It is a smart pointer that actually points`	119	`counted resource pointer. It is a smart pointer that actually points`
120	`to a ResourceRecord and not to the actual resource. Since the record`	120	`to a ResourceRecord and not to the actual resource. Since the record`
121	`contains a reference count, we can increase the reference count when`	121	`contains a reference count, we can increase the reference count when`
122	`the pointer is copied and decrease it in the destructor. Only the`	122	`the pointer is copied and decrease it in the destructor. Only the`
123	`ResourceManager can create ResourcePtr's directly from a raw`	123	`ResourceManager can create ResourcePtr's directly from a raw`
124	`ResourceRecord. */`	124	`ResourceRecord. */`
125	`template<class RES>`	125	`template<class RES>`
126	`class ResourcePtr`	126	`class ResourcePtr`
127	`{`	127	`{`
128	`typedef ResourceRecord<RES> RR;`	128	`typedef ResourceRecord<RES> RR;`
129	`typedef std::list<RR> RRList;`	129	`typedef std::list<RR> RRList;`
130	`typedef typename RRList::iterator RRListIter;`	130	`typedef typename RRList::iterator RRListIter;`
131		131
-		132	`static RRListIter get_null_rrlist_iter()`
-		133	`{`
-		134	`static RRList l;`
-		135	`return l.end();`
-		136	`}`
-		137
-		138	`#define NULL_RRLIST_ITER ResourcePtr<RES>::get_null_rrlist_iter()`
-		139
132	`friend class ResourceManager<RES>;`	140	`friend class ResourceManager<RES>;`
133		141
134	`private:`	142	`private:`
135	`RRListIter rr;`	143	`RRListIter rr;`
136	`RES* res;`	144	`RES* res;`
137		145
138	`/** Explicit constructor with value. The constructor can only be called`	146	`/** Explicit constructor with value. The constructor can only be called`
139	`by a friend, i.e. the resource manager. */`	147	`by a friend, i.e. the resource manager. */`
140	`explicit ResourcePtr(const RRListIter& _rr): rr(_rr), res(0)`	148	`explicit ResourcePtr(const RRListIter& _rr): rr(_rr), res(0)`
141	`{`	149	`{`
142	`if(rr != 0)`	150	`if(rr != NULL_RRLIST_ITER)`
143	`{`	151	`{`
144	`rr->increment_usage();`	152	`rr->increment_usage();`
145	`res = rr->get_ptr();`	153	`res = rr->get_ptr();`
146	`}`	154	`}`
147	`}`	155	`}`
148		156
149	`void decrement_usage();`	157	`void decrement_usage();`
150		158
151	`public:`	159	`public:`
152		160
153	`ResourcePtr(): rr(0), res(0) {}`	161	`ResourcePtr(): rr(NULL_RRLIST_ITER), res(0) {}`
154		162
155	`ResourcePtr(const ResourcePtr& r2): rr(r2.rr), res(0)`	163	`ResourcePtr(const ResourcePtr& r2): rr(r2.rr), res(0)`
156	`{`	164	`{`
157	`if(rr != 0)`	165	`if(rr != NULL_RRLIST_ITER)`
158	`{`	166	`{`
159	`rr->increment_usage();`	167	`rr->increment_usage();`
160	`res = rr->get_ptr();`	168	`res = rr->get_ptr();`
161	`}`	169	`}`
162	`}`	170	`}`
163		171
164	`const ResourcePtr& operator=(const ResourcePtr& r2)`	172	`const ResourcePtr& operator=(const ResourcePtr& r2)`
165	`{`	173	`{`
166	`// Guard against self-assignment`	174	`// Guard against self-assignment`
167	`if (r2.rr != this->rr)`	175	`if (r2.rr != this->rr)`
168	`{`	176	`{`
169	`if(rr != 0) decrement_usage();`	177	`if(rr != NULL_RRLIST_ITER) decrement_usage();`
170		178
171	`rr = r2.rr;`	179	`rr = r2.rr;`
172	`res = 0;`	180	`res = 0;`
173		181
174	`if(rr != 0)`	182	`if(rr != NULL_RRLIST_ITER)`
175	`{`	183	`{`
176	`res = rr->get_ptr();`	184	`res = rr->get_ptr();`
177	`rr->increment_usage();`	185	`rr->increment_usage();`
178	`}`	186	`}`
179	`}`	187	`}`
180	`return *this;`	188	`return *this;`
181	`}`	189	`}`
182		190
183	`~ResourcePtr() {decrement_usage();}`	191	`~ResourcePtr() {decrement_usage();}`
184		192
185	`RES& operator*() const`	193	`RES& operator*() const`
186	`{`	194	`{`
187	`assert(rr != 0);`	195	`assert(rr != NULL_RRLIST_ITER);`
188	`assert(res != 0);`	196	`assert(res != 0);`
189	`return *res;`	197	`return *res;`
190	`}`	198	`}`
191		199
192	`RES* const operator->() const`	200	`RES* const operator->() const`
193	`{`	201	`{`
194	`assert(rr != 0);`	202	`assert(rr != NULL_RRLIST_ITER);`
195	`assert(res !=0);`	203	`assert(res !=0);`
196	`return res;`	204	`return res;`
197	`}`	205	`}`
198		206
199	`RES* const get_raw_ptr() const`	207	`RES* const get_raw_ptr() const`
200	`{`	208	`{`
201	`assert(rr != 0);`	209	`assert(rr != NULL_RRLIST_ITER);`
202	`assert(res != 0);`	210	`assert(res != 0);`
203	`return res;`	211	`return res;`
204	`}`	212	`}`
205		213
206	`int usage() const`	214	`int usage() const`
207	`{`	215	`{`
208	`if(rr != 0)`	216	`if(rr != NULL_RRLIST_ITER)`
209	`return rr->get_usage();`	217	`return rr->get_usage();`
210	`return -1;`	218	`return -1;`
211	`}`	219	`}`
212		220
213	`bool is_valid() const {return rr != 0;}`	221	`bool is_valid() const {return rr != NULL_RRLIST_ITER;}`
214		222
215	`void relinquish_resource()`	223	`void relinquish_resource()`
216	`{`	224	`{`
217	`ResourcePtr p;`	225	`ResourcePtr p;`
218	`*this = p;`	226	`*this = p;`
219	`}`	227	`}`
220		228
221	`/** Calling this function sets the REMOVE_WHEN_UNUSED flag. If this`	229	`/** Calling this function sets the REMOVE_WHEN_UNUSED flag. If this`
222	`flag is set, the resource record is removed from the manager */`	230	`flag is set, the resource record is removed from the manager */`
223	`void remove_when_unused() { rr->remove_when_unused(); }`	231	`void remove_when_unused() { rr->remove_when_unused(); }`
224	`};`	232	`};`
225		233
226		234
227	`/** \brief Resource manager class.`	235	`/** \brief Resource manager class.`
228		236
229	`The ResourceManager is a singleton, and it uses Scott Meyers construct`	237	`The ResourceManager is a singleton, and it uses Scott Meyers construct`
230	`on first use idiom, i.e. the static function get_instance() will`	238	`on first use idiom, i.e. the static function get_instance() will`
231	`construct it when first called. There may be a problem with this`	239	`construct it when first called. There may be a problem with this`
232	`idion if resources depend on each other. However, that is only`	240	`idion if resources depend on each other. However, that is only`
233	`when the program shuts down. See modern C++ design by`	241	`when the program shuts down. See modern C++ design by`
234	`Alexandrescu for more information.`	242	`Alexandrescu for more information.`
235		243
236	`I'll try to make everything in this class private and accessed`	244	`I'll try to make everything in this class private and accessed`
237	`by a simple interface of friend functions.`	245	`by a simple interface of friend functions.`
238		246
239	`*/`	247	`*/`
240		248
241	`template<class RES>`	249	`template<class RES>`
242	`class ResourceManager`	250	`class ResourceManager`
243	`{`	251	`{`
244	`typedef ResourceRecord<RES> RR;`	252	`typedef ResourceRecord<RES> RR;`
245	`typedef std::list<RR> RRList;`	253	`typedef std::list<RR> RRList;`
246	`typedef typename RRList::iterator RRListIter;`	254	`typedef typename RRList::iterator RRListIter;`
247	`RRList resources;`	255	`RRList resources;`
248		256
249	`ResourceManager(): resources(0) {}`	257	`ResourceManager(): resources(0) {}`
250	`ResourceManager(const ResourceManager&);`	258	`ResourceManager(const ResourceManager&);`
251	`ResourceManager& operator=(const ResourceManager&);`	259	`ResourceManager& operator=(const ResourceManager&);`
252		260
253	`public:`	261	`public:`
254		262
255		263
256	`~ResourceManager()`	264	`~ResourceManager()`
257	`{`	265	`{`
258	`#if CLEAN_SHUTDOWN`	266	`#if CLEAN_SHUTDOWN`
259	`RRListIter i = resources.begin();`	267	`RRListIter i = resources.begin();`
260	`while(i != resources.end())`	268	`while(i != resources.end())`
261	`{`	269	`{`
262	`if(i->get_usage()==0)`	270	`if(i->get_usage()==0)`
263	`{`	271	`{`
264	`RRListIter tmp = i;`	272	`RRListIter tmp = i;`
265	`++i;`	273	`++i;`
266	`erase_resource(tmp);`	274	`erase_resource(tmp);`
267	`}`	275	`}`
268	`else`	276	`else`
269	`{`	277	`{`
270	`std::cout << "Warning, ResourceManager:\n\n"`	278	`std::cout << "Warning, ResourceManager:\n\n"`
271	`<< (typeid(this).name())`	279	`<< (typeid(this).name())`
272	`<< "\n\nis shutting down, and resource \n\n"`	280	`<< "\n\nis shutting down, and resource \n\n"`
273	`<< i->get_name() << "\n\nhas usage: " << i->get_usage()`	281	`<< i->get_name() << "\n\nhas usage: " << i->get_usage()`
274	`<< std::endl;`	282	`<< std::endl;`
275	`std::cout <<`	283	`std::cout <<`
276	`"In other words, this resource is not unused at this\n"`	284	`"In other words, this resource is not unused at this\n"`
277	`"point. That is unfortunate because then it cannot\n"`	285	`"point. That is unfortunate because then it cannot\n"`
278	`"be deleted (since it might be used by some other\n"`	286	`"be deleted (since it might be used by some other\n"`
279	`"part of the program during shutdown). Please ensure\n"`	287	`"part of the program during shutdown). Please ensure\n"`
280	`"that all resources are unused at program\n"`	288	`"that all resources are unused at program\n"`
281	`"termination. If you use a global ResourcePtr, this is\n"`	289	`"termination. If you use a global ResourcePtr, this is\n"`
282	`"done by calling relinquish_resource just before\n"`	290	`"done by calling relinquish_resource just before\n"`
283	`"exiting.\n"`	291	`"exiting.\n"`
284	`<< std::endl;`	292	`<< std::endl;`
285	`++i;`	293	`++i;`
286	`}`	294	`}`
287	`}`	295	`}`
288	`#endif`	296	`#endif`
289	`}`	297	`}`
290		298
291	`int get_no_resources() const`	299	`int get_no_resources() const`
292	`{`	300	`{`
293	`return resources.size();`	301	`return resources.size();`
294	`}`	302	`}`
295		303
296	`static ResourceManager& get_instance()`	304	`static ResourceManager& get_instance()`
297	`{`	305	`{`
298	`static ResourceManager instance;`	306	`static ResourceManager instance;`
299	`return instance;`	307	`return instance;`
300	`}`	308	`}`
301		309
302	`void erase_resource(RRListIter iter)`	310	`void erase_resource(RRListIter iter)`
303	`{`	311	`{`
304	`iter->erase_resource();`	312	`iter->erase_resource();`
305	`resources.erase(iter);`	313	`resources.erase(iter);`
306	`}`	314	`}`
307		315
308	`/** Find a resource and return a ResourcePtr to it. Returns the`	316	`/** Find a resource and return a ResourcePtr to it. Returns the`
309	`0 ResourcePtr if no string found. */`	317	`0 ResourcePtr if no string found. */`
310	`ResourcePtr<RES> get_resource_ptr(const std::string& str)`	318	`ResourcePtr<RES> get_resource_ptr(const std::string& str)`
311	`{`	319	`{`
312	`for(RRListIter i = resources.begin(); i != resources.end(); ++i)`	320	`for(RRListIter i = resources.begin(); i != resources.end(); ++i)`
313	`if((*i).get_name() == str)`	321	`if((*i).get_name() == str)`
314	`return ResourcePtr<RES>(i);`	322	`return ResourcePtr<RES>(i);`
315	`return ResourcePtr<RES>(0);`	323	`return ResourcePtr<RES>(NULL_RRLIST_ITER);`
316	`}`	324	`}`
317		325
318	`/** Add a resource with name passed as first argument and a pointer`	326	`/** Add a resource with name passed as first argument and a pointer`
319	`passed as 2nd argument. A ResourcePtr to the just inserted`	327	`passed as 2nd argument. A ResourcePtr to the just inserted`
320	`element is returned. */`	328	`element is returned. */`
321	`ResourcePtr<RES> register_resource(const std::string& str,`	329	`ResourcePtr<RES> register_resource(const std::string& str,`
322	`RES* res, bool static_resource)`	330	`RES* res, bool static_resource)`
323	`{`	331	`{`
324	`for(RRListIter i = resources.begin(); i != resources.end(); ++i)`	332	`for(RRListIter i = resources.begin(); i != resources.end(); ++i)`
325	`if(i->get_name() == str)`	333	`if(i->get_name() == str)`
326	`return (ResourcePtr<RES>(0));`	334	`return (ResourcePtr<RES>(NULL_RRLIST_ITER));`
327		335
328	`resources.push_front(RR(str, res, static_resource));`	336	`resources.push_front(RR(str, res, static_resource));`
329	`ResourcePtr<RES> ptr = ResourcePtr<RES>(resources.begin());`	337	`ResourcePtr<RES> ptr = ResourcePtr<RES>(resources.begin());`
330	`return ptr;`	338	`return ptr;`
331	`}`	339	`}`
332		340
333	`/* friend class ResourcePtr<RES>;`	341	`/* friend class ResourcePtr<RES>;`
334	`friend int get_no_resources<RES>();`	342	`friend int get_no_resources<RES>();`
335	`friend ResourcePtr<RES> get_resource_ptr<RES>(const std::string& str);`	343	`friend ResourcePtr<RES> get_resource_ptr<RES>(const std::string& str);`
336	`friend ResourcePtr<RES> register_static_resource<RES>(const std::string&,`	344	`friend ResourcePtr<RES> register_static_resource<RES>(const std::string&,`
337	`RES*);`	345	`RES*);`
338	`friend ResourcePtr<RES> register_dynamic_resource<RES>(const std::string&,`	346	`friend ResourcePtr<RES> register_dynamic_resource<RES>(const std::string&,`
339	`RES);/`	347	`RES);/`
340	`};`	348	`};`
341		349
342	`template<class RES>`	350	`template<class RES>`
343	`inline void ResourcePtr<RES>::decrement_usage()`	351	`inline void ResourcePtr<RES>::decrement_usage()`
344	`{`	352	`{`
345	`assert( (rr == 0) \|\| (res != 0));`	353	`assert( (rr == NULL_RRLIST_ITER) \|\| (res != 0));`
346	`if(rr != 0)`	354	`if(rr != NULL_RRLIST_ITER)`
347	`{`	355	`{`
348	`rr->decrement_usage();`	356	`rr->decrement_usage();`
349	`if(rr->get_usage() == 0 && (rr->get_flags()&REMOVE_WHEN_UNUSED))`	357	`if(rr->get_usage() == 0 && (rr->get_flags()&REMOVE_WHEN_UNUSED))`
350	`{`	358	`{`
351	`ResourceManager<RES>& man = ResourceManager<RES>::get_instance();`	359	`ResourceManager<RES>& man = ResourceManager<RES>::get_instance();`
352	`man.erase_resource(rr);`	360	`man.erase_resource(rr);`
353	`}`	361	`}`
354	`}`	362	`}`
355	`}`	363	`}`
356		364
357	`template<class RES>`	365	`template<class RES>`
358	`inline int get_no_resources()`	366	`inline int get_no_resources()`
359	`{`	367	`{`
360	`ResourceManager<RES>& man = ResourceManager<RES>::get_instance();`	368	`ResourceManager<RES>& man = ResourceManager<RES>::get_instance();`
361	`return man.get_no_resources();`	369	`return man.get_no_resources();`
362	`}`	370	`}`
363		371
364	`template<class RES>`	372	`template<class RES>`
365	`inline ResourcePtr<RES> get_resource_ptr(const std::string& str)`	373	`inline ResourcePtr<RES> get_resource_ptr(const std::string& str)`
366	`{`	374	`{`
367	`ResourceManager<RES>& man = ResourceManager<RES>::get_instance();`	375	`ResourceManager<RES>& man = ResourceManager<RES>::get_instance();`
368	`return man.get_resource_ptr(str);`	376	`return man.get_resource_ptr(str);`
369	`}`	377	`}`
370		378
371	`template<class RES>`	379	`template<class RES>`
372	`inline ResourcePtr<RES> register_dynamic_resource(const std::string& str,RES* res)`	380	`inline ResourcePtr<RES> register_dynamic_resource(const std::string& str,RES* res)`
373	`{`	381	`{`
374	`ResourceManager<RES>& man = ResourceManager<RES>::get_instance();`	382	`ResourceManager<RES>& man = ResourceManager<RES>::get_instance();`
375	`ResourcePtr<RES> ptr = man.register_resource(str, res, false);`	383	`ResourcePtr<RES> ptr = man.register_resource(str, res, false);`
376	`return ptr;`	384	`return ptr;`
377	`}`	385	`}`
378		386
379	`template<class RES>`	387	`template<class RES>`
380	`inline ResourcePtr<RES> register_static_resource(const std::string& str,RES* res)`	388	`inline ResourcePtr<RES> register_static_resource(const std::string& str,RES* res)`
381	`{`	389	`{`
382	`ResourceManager<RES>& man = ResourceManager<RES>::get_instance();`	390	`ResourceManager<RES>& man = ResourceManager<RES>::get_instance();`
383	`ResourcePtr<RES> ptr = man.register_resource(str, res, true);`	391	`ResourcePtr<RES> ptr = man.register_resource(str, res, true);`
384	`return ptr;`	392	`return ptr;`
385	`}`	393	`}`
386		394
387	`}`	395	`}`
388		396
389		397
390	`#endif`	398	`#endif`
391		399

Subversion Repositories gelsvn

(root)/trunk/src/Util/ResourceManager.h – Rev 89 → 129