khanat-opennel-code/code/nel/include/nel/misc/class_registry.h

123 lines
3.5 KiB
C++

// NeL - MMORPG Framework <http://dev.ryzom.com/projects/nel/>
// Copyright (C) 2010 Winch Gate Property Limited
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as
// published by the Free Software Foundation, either version 3 of the
// License, or (at your option) any later version.
//
// This program 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 Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program. If not, see <http://www.gnu.org/licenses/>.
#ifndef NL_CLASS_REGISTRY_H
#define NL_CLASS_REGISTRY_H
#include "types_nl.h"
#include "common.h"
#include <typeinfo>
#include <string>
#include <set>
namespace NLMISC
{
// ======================================================================================================
/**
* Class Registry Exception.
* \author Lionel Berenguier
* \author Nevrax France
* \date 2000
*/
struct ERegistry : public Exception
{
ERegistry() : Exception( "Registry error" ) {}
ERegistry( const std::string& str ) : Exception( str ) {}
};
struct ERegisteredClass : public ERegistry
{
ERegisteredClass() : ERegistry( "Class already registered" ) {}
};
struct EUnregisteredClass : public ERegistry
{
EUnregisteredClass() : ERegistry( "Class not registered" ) {}
EUnregisteredClass(const std::string &className) : ERegistry( std::string("Class not registered : ") + className ) {}
};
// ======================================================================================================
/**
* An Object Streamable interface.
* \author Lionel Berenguier
* \author Nevrax France
* \date 2000
*/
class IClassable
{
public:
virtual std::string getClassName() =0;
virtual ~IClassable() {}
};
// ======================================================================================================
/**
* The Class registry where we can instanciate IClassable objects from their names.
* \author Lionel Berenguier
* \author Nevrax France
* \date 2000
*/
class CClassRegistry
{
public:
/// Inits the ClassRegistry (especially RegistredClasses)
static void init();
/// release memory
static void release();
/// Register your class for future Instanciation.
static void registerClass(const std::string &className, IClassable* (*creator)(), const std::string &typeidCheck) throw(ERegistry);
/// Create an object from his class name.
static IClassable *create(const std::string &className) throw(ERegistry);
/// check if the object has been correctly registered. Must be used for debug only, and Must compile with RTTI.
static bool checkObject(IClassable* obj);
private:
struct CClassNode
{
std::string TypeIdCheck;
IClassable* (*Creator)();
};
typedef CHashMap<std::string, CClassNode> TClassMap;
static TClassMap *RegistredClasses;
};
/// Useful Macros.
#define NLMISC_DECLARE_CLASS(_class_) \
virtual std::string getClassName() {return #_class_;} \
static NLMISC::IClassable *creator() {return new _class_;}
#define NLMISC_REGISTER_CLASS(_class_) NLMISC::CClassRegistry::registerClass(#_class_, _class_::creator, typeid(_class_).name());
} // namespace NLMISC.
#endif // NL_STREAM_H
/* End of stream.h */