watrbx-game-engine/App/reflection/Descriptor.h

#pragma once

#include "util/Name.h"
#include "boost/utility.hpp"
#include <boost/thread/mutex.hpp>

namespace RBX
{
	namespace Reflection
	{
		class Descriptor : public boost::noncopyable
		{

            static void checkLockedDown()
			{
				// If this following assertion fails then you need to put your class 
				// into FactoryRegistrator::FactoryRegistrator() or somewhere else.
				// Failure of this test is so severe that we want to catch it in production, too.
				if (lockedDown)
					RBXCRASH();
			}
		public:
			struct Attributes
			{
				bool isDeprecated;
				const Descriptor* preferred;	// used if isDeprecated 
				Attributes()
					:isDeprecated(false)
					,preferred(NULL)
				{}
				static Attributes deprecated(const Descriptor& preferred)
				{
					Attributes result;
					result.isDeprecated = true;
					result.preferred = &preferred;
					return result;
				}
				static Attributes deprecated()
				{
					Attributes result;
					result.isDeprecated = true;
					return result;
				}

			};

			static bool lockedDown;	// After the first instance of a described class is created we cannot modify the reflection database

			const RBX::Name& name; 
            scoped_ptr<bool> isReplicable;
            scoped_ptr<bool> isOutdated;
			const Attributes attributes;

			Descriptor(const char* name, Attributes attributes)
				:name(RBX::Name::declare(name))
				,attributes(attributes)
                ,isReplicable(new bool(false))
                ,isOutdated(new bool(false))
			{
				checkLockedDown();
				RBXASSERT(!this->name.empty());
			}
			Descriptor(const RBX::Name& name, Attributes attributes)
				:name(name)
				,attributes(attributes)
                ,isReplicable(new bool(false))
                ,isOutdated(new bool(false))
			{
				checkLockedDown();
				RBXASSERT(!this->name.empty());
			}
			virtual ~Descriptor() {}
		};
	}
}