27 #ifndef _CEGUINamedXMLResourceManager_h_ 28 #define _CEGUINamedXMLResourceManager_h_ 30 #include "CEGUI/EventSet.h" 31 #include "CEGUI/String.h" 32 #include "CEGUI/Exceptions.h" 33 #include "CEGUI/Logger.h" 34 #include "CEGUI/InputEvent.h" 35 #include "CEGUI/System.h" 55 class CEGUIEXPORT ResourceEventSet :
public EventSet 59 static const String EventNamespace;
66 static const String EventResourceCreated;
73 static const String EventResourceDestroyed;
80 static const String EventResourceReplaced;
107 template<
typename T,
typename U>
167 T& createFromFile(
const String& xml_filename,
const String& resource_group =
"",
187 T& createFromString(
const String& source,
198 void destroy(
const String& object_name);
209 void destroy(
const T&
object);
224 T&
get(
const String& object_name)
const;
227 bool isDefined(
const String& object_name)
const;
230 void createAll(
const String& pattern,
const String& resource_group);
238 void destroyObject(
typename ObjectRegistry::iterator ob);
240 T& doExistingObjectAction(
const String object_name, T*
object,
243 virtual void doPostObjectAdditionAction(T&
object);
245 const String d_resourceType;
251 template<
typename T,
typename U>
253 const String& resource_type) :
254 d_resourceType(resource_type)
259 template<
typename T,
typename U>
265 template<
typename T,
typename U>
271 xml_loader.handleContainer(source);
272 return doExistingObjectAction(xml_loader.getObjectName(),
273 &xml_loader.getObject(), action);
277 template<
typename T,
typename U>
279 const String& resource_group,
284 xml_loader.handleFile(xml_filename, resource_group);
285 return doExistingObjectAction(xml_loader.getObjectName(),
286 &xml_loader.getObject(), action);
290 template<
typename T,
typename U>
296 xml_loader.handleString(source);
297 return doExistingObjectAction(xml_loader.getObjectName(),
298 &xml_loader.getObject(), action);
302 template<
typename T,
typename U>
305 typename ObjectRegistry::iterator i(d_objects.find(object_name));
308 if (i == d_objects.end())
315 template<
typename T,
typename U>
320 typename ObjectRegistry::iterator i(d_objects.begin());
321 for (; i != d_objects.end(); ++i)
322 if (i->second == &
object)
330 template<
typename T,
typename U>
333 while (!d_objects.empty())
334 destroyObject(d_objects.begin());
338 template<
typename T,
typename U>
341 typename ObjectRegistry::const_iterator i(d_objects.find(object_name));
343 if (i == d_objects.end())
345 "No object of type '" + d_resourceType +
"' named '" + object_name +
346 "' is present in the collection."));
352 template<
typename T,
typename U>
355 return d_objects.find(object_name) != d_objects.end();
359 template<
typename T,
typename U>
361 typename ObjectRegistry::iterator ob)
364 sprintf(addr_buff,
"(%p)", static_cast<void*>(ob->second));
365 Logger::getSingleton().logEvent(
"Object of type '" + d_resourceType +
366 "' named '" + ob->first +
"' has been destroyed. " +
367 addr_buff, Informative);
372 CEGUI_DELETE_AO ob->second;
376 fireEvent(EventResourceDestroyed, args, EventNamespace);
380 template<
typename T,
typename U>
388 if (isDefined(object_name))
393 Logger::getSingleton().logEvent(
"---- Returning existing instance " 394 "of " + d_resourceType +
" named '" + object_name +
"'.");
396 CEGUI_DELETE_AO object;
398 return *d_objects[object_name];
401 Logger::getSingleton().logEvent(
"---- Replacing existing instance " 402 "of " + d_resourceType +
" named '" + object_name +
404 destroy(object_name);
405 event_name = EventResourceReplaced;
409 CEGUI_DELETE_AO object;
411 "an object of type '" + d_resourceType +
"' named '" +
412 object_name +
"' already exists in the collection."));
415 CEGUI_DELETE_AO object;
417 "Invalid CEGUI::XMLResourceExistsAction was specified."));
421 event_name = EventResourceCreated;
423 d_objects[object_name] = object;
424 doPostObjectAdditionAction(*
object);
428 fireEvent(event_name, args, EventNamespace);
434 template<
typename T,
typename U>
441 template<
typename T,
typename U>
443 const String& resource_group)
445 std::vector<String> names;
446 const size_t num = System::getSingleton().getResourceProvider()->
447 getResourceGroupFileNames(names, pattern, resource_group);
449 for (
size_t i = 0; i < num; ++i)
450 createFromFile(names[i], resource_group);
457 #endif // end of guard _CEGUINamedXMLResourceManager_h_ Exception class used when a request was made for an unknown object.
Definition: cegui/include/CEGUI/Exceptions.h:246
Functor that can be used as comparator in a std::map with String keys. It's faster than using the def...
Definition: cegui/include/CEGUI/String.h:5579
EventArgs based class that is used for notifications regarding resources.
Definition: cegui/include/CEGUI/InputEvent.h:365
Main namespace for Crazy Eddie's GUI Library.
Definition: cegui/include/CEGUI/Affector.h:42
Exception class used when an attempt is made create a named object of a particular type when an objec...
Definition: cegui/include/CEGUI/Exceptions.h:483
Class used as the databuffer for loading files throughout the library.
Definition: cegui/include/CEGUI/DataContainer.h:42
Throw an AlreadyExistsException.
Definition: cegui/include/CEGUI/NamedXMLResourceManager.h:49
std::map< String, T *, StringFastLessCompare CEGUI_MAP_ALLOC(String, T *)> ObjectRegistry
type of collection used to store and manage objects
Definition: debian/tmp/usr/include/cegui-0.8.7/CEGUI/NamedXMLResourceManager.h:236
NamedXMLResourceManager(const String &resource_type)
Constructor.
Definition: cegui/include/CEGUI/NamedXMLResourceManager.h:252
Interface providing event signaling and handling.
Definition: cegui/include/CEGUI/EventSet.h:166
Destroy the existing instance and replace with the newly loaded one.
Definition: cegui/include/CEGUI/NamedXMLResourceManager.h:47
Templatised manager class that loads and manages named XML based resources.
Definition: cegui/include/CEGUI/NamedXMLResourceManager.h:108
Exception class used when some impossible request was made of the system.
Definition: cegui/include/CEGUI/Exceptions.h:304
XMLResourceExistsAction
Possible actions when loading an XML resource that already exists.
Definition: cegui/include/CEGUI/NamedXMLResourceManager.h:42
Do not load the resource, return the existing instance.
Definition: cegui/include/CEGUI/NamedXMLResourceManager.h:45
String class used within the GUI system.
Definition: cegui/include/CEGUI/String.h:62