OpenStack Study: serializer.py

**** CubicPower OpenStack Study ****

# Copyright 2013 IBM Corp.

#

# Licensed under the Apache License, Version 2.0 (the "License"); you may

# not use this file except in compliance with the License. You may obtain

# a copy of the License at

#

# http://www.apache.org/licenses/LICENSE-2.0

#

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT

# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

# License for the specific language governing permissions and limitations

# under the License.

"""Provides the definition of an RPC serialization handler"""

import abc

import six

@six.add_metaclass(abc.ABCMeta)

**** CubicPower OpenStack Study ****

class Serializer(object):

"""Generic (de-)serialization

**** CubicPower OpenStack Study ****

    def serialize_entity(self, context, entity):

        """Serialize something to primitive form.

        :param context: Security context

        :param entity: Entity to be serialized

        :returns: Serialized form of entity

        """

        pass

    @abc.abstractmethod

**** CubicPower OpenStack Study ****

    def deserialize_entity(self, context, entity):

        """Deserialize something from primitive form.

        :param context: Security context

        :param entity: Primitive to be deserialized

        :returns: Deserialized form of entity

        """

        pass

**** CubicPower OpenStack Study ****

class NoOpSerializer(Serializer):

"""A serializer that does nothing."""

**** CubicPower OpenStack Study ****

    def serialize_entity(self, context, entity):

        return entity

**** CubicPower OpenStack Study ****

    def deserialize_entity(self, context, entity):

        return entity