The nova.objects.base Module

Nova common internal object model

class NovaObject(context=None, **kwargs)

Bases: oslo_versionedobjects.base.VersionedObject

Base class and object factory.

This forms the base of all objects that can be remoted or instantiated via RPC. Simply defining a class that inherits from this base class will make it remotely instantiatable. Objects should implement the necessary “get” classmethod routines as well as “save” object methods as appropriate.

OBJ_PROJECT_NAMESPACE = 'nova'

OBJ_SERIAL_NAMESPACE = 'nova_object'

obj_alternate_context(*args, **kwds)

obj_as_admin(*args, **kwds)

Context manager to make an object call as an admin.

This temporarily modifies the context embedded in an object to be elevated() and restores it after the call completes. Example usage:

with obj.obj_as_admin():

obj.save()

obj_calculate_child_version(target_version, child)

Calculate the appropriate version for a child object.

This is to be used when backporting an object for an older client. A sub-object will need to be backported to a suitable version for the client as well, and this method will calculate what that version should be, based on obj_relationships.

Parameters:

• target_version – Version this object is being backported to
• child – The child field for which the appropriate version is to be calculated

Returns:

None if the child should be omitted from the backport, otherwise, the version to which the child should be backported

obj_reset_changes(fields=None, recursive=False)

Reset the list of fields that have been changed.

Note

• This is NOT “revert to previous values”
• Specifying fields on recursive resets will only be honored at the top level. Everything below the top will reset all.

Parameters:

• fields – List of fields to reset, or “all” if None.
• recursive – Call obj_reset_changes(recursive=True) on any sub-objects within the list of fields being reset.

class NovaObjectDictCompat

Bases: oslo_versionedobjects.base.VersionedObjectDictCompat

keys()

class NovaObjectRegistry

Bases: oslo_versionedobjects.base.VersionedObjectRegistry

registration_hook(cls, index)

class NovaObjectSerializer

Bases: oslo_messaging.serializer.NoOpSerializer

A NovaObject-aware Serializer.

This implements the Oslo Serializer interface and provides the ability to serialize and deserialize NovaObject entities. Any service that needs to accept or return NovaObjects as arguments or result values should pass this to its RPCClient and RPCServer objects.

conductor

deserialize_entity(context, entity)

serialize_entity(context, entity)

class NovaPersistentObject

Bases: object

Mixin class for Persistent objects.

This adds the fields that we use in common for most persistent objects.

fields = {'created_at': DateTime(default=<class 'oslo_versionedobjects.fields.UnspecifiedDefault'>,nullable=True), 'deleted': Boolean(default=False,nullable=False), 'updated_at': DateTime(default=<class 'oslo_versionedobjects.fields.UnspecifiedDefault'>,nullable=True), 'deleted_at': DateTime(default=<class 'oslo_versionedobjects.fields.UnspecifiedDefault'>,nullable=True)}

class NovaTimestampObject

Bases: object

Mixin class for db backed objects with timestamp fields.

Sqlalchemy models that inherit from the oslo_db TimestampMixin will include these fields and the corresponding objects will benefit from this mixin.

fields = {'created_at': DateTime(default=<class 'oslo_versionedobjects.fields.UnspecifiedDefault'>,nullable=True), 'updated_at': DateTime(default=<class 'oslo_versionedobjects.fields.UnspecifiedDefault'>,nullable=True)}

class ObjectListBase(*args, **kwargs)

Bases: oslo_versionedobjects.base.ObjectListBase

get_attrname(name)

Return the mangled name of the attribute’s underlying storage.

obj_equal_prims(obj_1, obj_2, ignore=None)

Compare two primitives for equivalence ignoring some keys.

This operation tests the primitives of two objects for equivalence. Object primitives may contain a list identifying fields that have been changed - this is ignored in the comparison. The ignore parameter lists any other keys to be ignored.

:param:obj1: The first object in the comparison :param:obj2: The second object in the comparison :param:ignore: A list of fields to ignore :returns: True if the primitives are equal ignoring changes and specified fields, otherwise False.

obj_make_list(context, list_obj, item_cls, db_list, **extra_args)

Construct an object list from a list of primitives.

This calls item_cls._from_db_object() on each item of db_list, and adds the resulting object to list_obj.

:param:context: Request context :param:list_obj: An ObjectListBase object :param:item_cls: The NovaObject class of the objects within the list :param:db_list: The list of primitives to convert to objects :param:extra_args: Extra arguments to pass to _from_db_object() :returns: list_obj

obj_to_primitive(obj)

Recursively turn an object into a python primitive.

A NovaObject becomes a dict, and anything that implements ObjectListBase becomes a list.

serialize_args(fn)

Decorator that will do the arguments serialization before remoting.