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" 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);
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. " +
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: 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: String.h:5579
EventArgs based class that is used for notifications regarding resources.
Definition: InputEvent.h:365
Main namespace for Crazy Eddie's GUI Library.
Definition: arch_overview.dox:1
Exception class used when an attempt is made create a named object of a particular type when an objec...
Definition: Exceptions.h:483
Useful tracing (object creations etc) information will be logged.
Definition: Logger.h:61
static const String EventNamespace
Namespace name for all resource managers.
Definition: NamedXMLResourceManager.h:59
Destroy the existing instance and replace with the newly loaded one.
Definition: NamedXMLResourceManager.h:47
static const String EventResourceReplaced
Definition: NamedXMLResourceManager.h:80
Class used as the databuffer for loading files throughout the library.
Definition: DataContainer.h:42
std::map< String, T *, StringFastLessCompare CEGUI_MAP_ALLOC(String, T *)> ObjectRegistry
type of collection used to store and manage objects
Definition: NamedXMLResourceManager.h:236
NamedXMLResourceManager(const String &resource_type)
Constructor.
Definition: NamedXMLResourceManager.h:252
static const String EventResourceCreated
Definition: NamedXMLResourceManager.h:66
Interface providing event signaling and handling.
Definition: EventSet.h:166
Templatised manager class that loads and manages named XML based resources.
Definition: NamedXMLResourceManager.h:108
static const String EventResourceDestroyed
Definition: NamedXMLResourceManager.h:73
Exception class used when some impossible request was made of the system.
Definition: Exceptions.h:304
XMLResourceExistsAction
Possible actions when loading an XML resource that already exists.
Definition: NamedXMLResourceManager.h:42
Do not load the resource, return the existing instance.
Definition: NamedXMLResourceManager.h:45
implementation class to gather EventSet parts for all template instances.
Definition: NamedXMLResourceManager.h:55
const String d_resourceType
String holding the text for the resource type managed.
Definition: NamedXMLResourceManager.h:245
Throw an AlreadyExistsException.
Definition: NamedXMLResourceManager.h:49
String class used within the GUI system.
Definition: String.h:62
ObjectRegistry d_objects
the collection of objects
Definition: NamedXMLResourceManager.h:247