// // Copyright (c) 2008-2014 the Urho3D project. // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN // THE SOFTWARE. // #include "Precompiled.h" #include "Context.h" #include "Deserializer.h" #include "Log.h" #include "ReplicationState.h" #include "SceneEvents.h" #include "Serializable.h" #include "Serializer.h" #include "XMLElement.h" #include "DebugNew.h" namespace Urho3D { Serializable::Serializable(Context* context) : Object(context), networkState_(0), instanceDefaultValues_(0), temporary_(false) { } Serializable::~Serializable() { delete networkState_; networkState_ = 0; delete instanceDefaultValues_; instanceDefaultValues_ = 0; } void Serializable::OnSetAttribute(const AttributeInfo& attr, const Variant& src) { // Check for accessor function mode if (attr.accessor_) { attr.accessor_->Set(this, src); return; } // Calculate the destination address void* dest = attr.ptr_ ? attr.ptr_ : reinterpret_cast(this) + attr.offset_; switch (attr.type_) { case VAR_INT: // If enum type, use the low 8 bits only if (attr.enumNames_) *(reinterpret_cast(dest)) = src.GetInt(); else *(reinterpret_cast(dest)) = src.GetInt(); break; case VAR_BOOL: *(reinterpret_cast(dest)) = src.GetBool(); break; case VAR_FLOAT: *(reinterpret_cast(dest)) = src.GetFloat(); break; case VAR_VECTOR2: *(reinterpret_cast(dest)) = src.GetVector2(); break; case VAR_VECTOR3: *(reinterpret_cast(dest)) = src.GetVector3(); break; case VAR_VECTOR4: *(reinterpret_cast(dest)) = src.GetVector4(); break; case VAR_QUATERNION: *(reinterpret_cast(dest)) = src.GetQuaternion(); break; case VAR_COLOR: *(reinterpret_cast(dest)) = src.GetColor(); break; case VAR_STRING: *(reinterpret_cast(dest)) = src.GetString(); break; case VAR_BUFFER: *(reinterpret_cast*>(dest)) = src.GetBuffer(); break; case VAR_RESOURCEREF: *(reinterpret_cast(dest)) = src.GetResourceRef(); break; case VAR_RESOURCEREFLIST: *(reinterpret_cast(dest)) = src.GetResourceRefList(); break; case VAR_VARIANTVECTOR: *(reinterpret_cast(dest)) = src.GetVariantVector(); break; case VAR_VARIANTMAP: *(reinterpret_cast(dest)) = src.GetVariantMap(); break; case VAR_INTRECT: *(reinterpret_cast(dest)) = src.GetIntRect(); break; case VAR_INTVECTOR2: *(reinterpret_cast(dest)) = src.GetIntVector2(); break; default: LOGERROR("Unsupported attribute type for OnSetAttribute()"); return; } // If it is a network attribute then mark it for next network update if (attr.mode_ & AM_NET) MarkNetworkUpdate(); } void Serializable::OnGetAttribute(const AttributeInfo& attr, Variant& dest) const { // Check for accessor function mode if (attr.accessor_) { attr.accessor_->Get(this, dest); return; } // Calculate the source address const void* src = attr.ptr_ ? attr.ptr_ : reinterpret_cast(this) + attr.offset_; switch (attr.type_) { case VAR_INT: // If enum type, use the low 8 bits only if (attr.enumNames_) dest = *(reinterpret_cast(src)); else dest = *(reinterpret_cast(src)); break; case VAR_BOOL: dest = *(reinterpret_cast(src)); break; case VAR_FLOAT: dest = *(reinterpret_cast(src)); break; case VAR_VECTOR2: dest = *(reinterpret_cast(src)); break; case VAR_VECTOR3: dest = *(reinterpret_cast(src)); break; case VAR_VECTOR4: dest = *(reinterpret_cast(src)); break; case VAR_QUATERNION: dest = *(reinterpret_cast(src)); break; case VAR_COLOR: dest = *(reinterpret_cast(src)); break; case VAR_STRING: dest = *(reinterpret_cast(src)); break; case VAR_BUFFER: dest = *(reinterpret_cast*>(src)); break; case VAR_RESOURCEREF: dest = *(reinterpret_cast(src)); break; case VAR_RESOURCEREFLIST: dest = *(reinterpret_cast(src)); break; case VAR_VARIANTVECTOR: dest = *(reinterpret_cast(src)); break; case VAR_VARIANTMAP: dest = *(reinterpret_cast(src)); break; case VAR_INTRECT: dest = *(reinterpret_cast(src)); break; case VAR_INTVECTOR2: dest = *(reinterpret_cast(src)); break; default: LOGERROR("Unsupported attribute type for OnGetAttribute()"); return; } } const Vector* Serializable::GetAttributes() const { return context_->GetAttributes(GetType()); } const Vector* Serializable::GetNetworkAttributes() const { return networkState_ ? networkState_->attributes_ : context_->GetNetworkAttributes(GetType()); } bool Serializable::Load(Deserializer& source, bool setInstanceDefault) { const Vector* attributes = GetAttributes(); if (!attributes) return true; for (unsigned i = 0; i < attributes->Size(); ++i) { const AttributeInfo& attr = attributes->At(i); if (!(attr.mode_ & AM_FILE)) continue; if (source.IsEof()) { LOGERROR("Could not load " + GetTypeName() + ", stream not open or at end"); return false; } Variant varValue = source.ReadVariant(attr.type_); OnSetAttribute(attr, varValue); if (setInstanceDefault) SetInstanceDefault(attr.name_, varValue); } return true; } bool Serializable::Save(Serializer& dest) const { const Vector* attributes = GetAttributes(); if (!attributes) return true; Variant value; for (unsigned i = 0; i < attributes->Size(); ++i) { const AttributeInfo& attr = attributes->At(i); if (!(attr.mode_ & AM_FILE)) continue; OnGetAttribute(attr, value); if (!dest.WriteVariantData(value)) { LOGERROR("Could not save " + GetTypeName() + ", writing to stream failed"); return false; } } return true; } bool Serializable::LoadXML(const XMLElement& source, bool setInstanceDefault) { if (source.IsNull()) { LOGERROR("Could not load " + GetTypeName() + ", null source element"); return false; } const Vector* attributes = GetAttributes(); if (!attributes) return true; XMLElement attrElem = source.GetChild("attribute"); unsigned startIndex = 0; while (attrElem) { String name = attrElem.GetAttribute("name"); unsigned i = startIndex; unsigned attempts = attributes->Size(); while (attempts) { const AttributeInfo& attr = attributes->At(i); if ((attr.mode_ & AM_FILE) && !attr.name_.Compare(name, true)) { Variant varValue; // If enums specified, do enum lookup and int assignment. Otherwise assign the variant directly if (attr.enumNames_) { String value = attrElem.GetAttribute("value"); bool enumFound = false; int enumValue = 0; const char** enumPtr = attr.enumNames_; while (*enumPtr) { if (!value.Compare(*enumPtr, false)) { enumFound = true; break; } ++enumPtr; ++enumValue; } if (enumFound) varValue = enumValue; else LOGWARNING("Unknown enum value " + value + " in attribute " + attr.name_); } else varValue = attrElem.GetVariantValue(attr.type_); if (!varValue.IsEmpty()) { OnSetAttribute(attr, varValue); if (setInstanceDefault) SetInstanceDefault(attr.name_, varValue); } startIndex = (i + 1) % attributes->Size(); break; } else { i = (i + 1) % attributes->Size(); --attempts; } } if (!attempts) LOGWARNING("Unknown attribute " + name + " in XML data"); attrElem = attrElem.GetNext("attribute"); } return true; } bool Serializable::SaveXML(XMLElement& dest) const { if (dest.IsNull()) { LOGERROR("Could not save " + GetTypeName() + ", null destination element"); return false; } const Vector* attributes = GetAttributes(); if (!attributes) return true; Variant value; for (unsigned i = 0; i < attributes->Size(); ++i) { const AttributeInfo& attr = attributes->At(i); if (!(attr.mode_ & AM_FILE)) continue; OnGetAttribute(attr, value); Variant defaultValue(GetAttributeDefault(i)); // In XML serialization default values can be skipped. This will make the file easier to read or edit manually if (value == defaultValue && !SaveDefaultAttributes()) continue; XMLElement attrElem = dest.CreateChild("attribute"); attrElem.SetAttribute("name", attr.name_); // If enums specified, set as an enum string. Otherwise set directly as a Variant if (attr.enumNames_) { int enumValue = value.GetInt(); attrElem.SetAttribute("value", attr.enumNames_[enumValue]); } else attrElem.SetVariantValue(value); } return true; } bool Serializable::SetAttribute(unsigned index, const Variant& value) { const Vector* attributes = GetAttributes(); if (!attributes) { LOGERROR(GetTypeName() + " has no attributes"); return false; } if (index >= attributes->Size()) { LOGERROR("Attribute index out of bounds"); return false; } const AttributeInfo& attr = attributes->At(index); // Check that the new value's type matches the attribute type if (value.GetType() == attr.type_) { OnSetAttribute(attr, value); return true; } else { LOGERROR("Could not set attribute " + attr.name_ + ": expected type " + Variant::GetTypeName(attr.type_) + " but got " + value.GetTypeName()); return false; } } bool Serializable::SetAttribute(const String& name, const Variant& value) { const Vector* attributes = GetAttributes(); if (!attributes) { LOGERROR(GetTypeName() + " has no attributes"); return false; } for (Vector::ConstIterator i = attributes->Begin(); i != attributes->End(); ++i) { if (!i->name_.Compare(name, true)) { // Check that the new value's type matches the attribute type if (value.GetType() == i->type_) { OnSetAttribute(*i, value); return true; } else { LOGERROR("Could not set attribute " + i->name_ + ": expected type " + Variant::GetTypeName(i->type_) + " but got " + value.GetTypeName()); return false; } } } LOGERROR("Could not find attribute " + name + " in " + GetTypeName()); return false; } void Serializable::ResetToDefault() { const Vector* attributes = GetAttributes(); if (!attributes) return; for (unsigned i = 0; i < attributes->Size(); ++i) { const AttributeInfo& attr = attributes->At(i); if (attr.mode_ & (AM_NOEDIT | AM_NODEID | AM_COMPONENTID | AM_NODEIDVECTOR)) continue; Variant defaultValue = GetInstanceDefault(attr.name_); if (defaultValue.IsEmpty()) defaultValue = attr.defaultValue_; OnSetAttribute(attr, defaultValue); } } void Serializable::RemoveInstanceDefault() { delete instanceDefaultValues_; instanceDefaultValues_ = 0; } void Serializable::SetTemporary(bool enable) { if (enable != temporary_) { temporary_ = enable; using namespace TemporaryChanged; VariantMap& eventData = GetEventDataMap(); eventData[P_SERIALIZABLE] = this; SendEvent(E_TEMPORARYCHANGED, eventData); } } void Serializable::AllocateNetworkState() { if (!networkState_) { const Vector* networkAttributes = GetNetworkAttributes(); networkState_ = new NetworkState(); networkState_->attributes_ = networkAttributes; } } void Serializable::WriteInitialDeltaUpdate(Serializer& dest) { if (!networkState_) { LOGERROR("WriteInitialDeltaUpdate called without allocated NetworkState"); return; } const Vector* attributes = networkState_->attributes_; if (!attributes) return; unsigned numAttributes = attributes->Size(); DirtyBits attributeBits; // Compare against defaults for (unsigned i = 0; i < numAttributes; ++i) { const AttributeInfo& attr = attributes->At(i); if (networkState_->currentValues_[i] != attr.defaultValue_) attributeBits.Set(i); } // First write the change bitfield, then attribute data for non-default attributes dest.Write(attributeBits.data_, (numAttributes + 7) >> 3); for (unsigned i = 0; i < numAttributes; ++i) { if (attributeBits.IsSet(i)) dest.WriteVariantData(networkState_->currentValues_[i]); } } void Serializable::WriteDeltaUpdate(Serializer& dest, const DirtyBits& attributeBits) { if (!networkState_) { LOGERROR("WriteDeltaUpdate called without allocated NetworkState"); return; } const Vector* attributes = networkState_->attributes_; if (!attributes) return; unsigned numAttributes = attributes->Size(); // First write the change bitfield, then attribute data for changed attributes // Note: the attribute bits should not contain LATESTDATA attributes dest.Write(attributeBits.data_, (numAttributes + 7) >> 3); for (unsigned i = 0; i < numAttributes; ++i) { if (attributeBits.IsSet(i)) dest.WriteVariantData(networkState_->currentValues_[i]); } } void Serializable::WriteLatestDataUpdate(Serializer& dest) { if (!networkState_) { LOGERROR("WriteLatestDataUpdate called without allocated NetworkState"); return; } const Vector* attributes = networkState_->attributes_; if (!attributes) return; unsigned numAttributes = attributes->Size(); for (unsigned i = 0; i < numAttributes; ++i) { if (attributes->At(i).mode_ & AM_LATESTDATA) dest.WriteVariantData(networkState_->currentValues_[i]); } } void Serializable::ReadDeltaUpdate(Deserializer& source) { const Vector* attributes = GetNetworkAttributes(); if (!attributes) return; unsigned numAttributes = attributes->Size(); DirtyBits attributeBits; source.Read(attributeBits.data_, (numAttributes + 7) >> 3); for (unsigned i = 0; i < numAttributes && !source.IsEof(); ++i) { if (attributeBits.IsSet(i)) { const AttributeInfo& attr = attributes->At(i); OnSetAttribute(attr, source.ReadVariant(attr.type_)); } } } void Serializable::ReadLatestDataUpdate(Deserializer& source) { const Vector* attributes = GetNetworkAttributes(); if (!attributes) return; unsigned numAttributes = attributes->Size(); for (unsigned i = 0; i < numAttributes && !source.IsEof(); ++i) { const AttributeInfo& attr = attributes->At(i); if (attr.mode_ & AM_LATESTDATA) OnSetAttribute(attr, source.ReadVariant(attr.type_)); } } Variant Serializable::GetAttribute(unsigned index) const { Variant ret; const Vector* attributes = GetAttributes(); if (!attributes) { LOGERROR(GetTypeName() + " has no attributes"); return ret; } if (index >= attributes->Size()) { LOGERROR("Attribute index out of bounds"); return ret; } OnGetAttribute(attributes->At(index), ret); return ret; } Variant Serializable::GetAttribute(const String& name) const { Variant ret; const Vector* attributes = GetAttributes(); if (!attributes) { LOGERROR(GetTypeName() + " has no attributes"); return ret; } for (Vector::ConstIterator i = attributes->Begin(); i != attributes->End(); ++i) { if (!i->name_.Compare(name, true)) { OnGetAttribute(*i, ret); return ret; } } LOGERROR("Could not find attribute " + name + " in " + GetTypeName()); return ret; } Variant Serializable::GetAttributeDefault(unsigned index) const { const Vector* attributes = GetAttributes(); if (!attributes) { LOGERROR(GetTypeName() + " has no attributes"); return Variant::EMPTY; } if (index >= attributes->Size()) { LOGERROR("Attribute index out of bounds"); return Variant::EMPTY; } AttributeInfo attr = attributes->At(index); Variant defaultValue = GetInstanceDefault(attr.name_); return defaultValue.IsEmpty() ? attr.defaultValue_ : defaultValue; } Variant Serializable::GetAttributeDefault(const String& name) const { Variant defaultValue = GetInstanceDefault(name); if (!defaultValue.IsEmpty()) return defaultValue; const Vector* attributes = GetAttributes(); if (!attributes) { LOGERROR(GetTypeName() + " has no attributes"); return Variant::EMPTY; } for (Vector::ConstIterator i = attributes->Begin(); i != attributes->End(); ++i) { if (!i->name_.Compare(name, true)) return i->defaultValue_; } LOGERROR("Could not find attribute " + name + " in " + GetTypeName()); return Variant::EMPTY; } unsigned Serializable::GetNumAttributes() const { const Vector* attributes = GetAttributes(); return attributes ? attributes->Size() : 0; } unsigned Serializable::GetNumNetworkAttributes() const { const Vector* attributes = networkState_ ? networkState_->attributes_ : context_->GetNetworkAttributes(GetType()); return attributes ? attributes->Size() : 0; } void Serializable::SetInstanceDefault(const String& name, const Variant& defaultValue) { // Allocate the instance level default value if (!instanceDefaultValues_) instanceDefaultValues_ = new VariantMap(); instanceDefaultValues_->operator[] (name) = defaultValue; } Variant Serializable::GetInstanceDefault(const String& name) const { if (instanceDefaultValues_) { VariantMap::ConstIterator i = instanceDefaultValues_->Find(name); if (i != instanceDefaultValues_->End()) return i->second_; } return Variant::EMPTY; } }