django rest framework - 数据解析

全部数据解析的类都是BaseParser的子类。

class BaseParser(object):
    """
    All parsers should extend `BaseParser`, specifying a `media_type`
    attribute, and overriding the `.parse()` method.
    """

    media_type = None

    def parse(self, stream, media_type=None, parser_context=None):
        """
        Given a stream to read from, return the parsed representation.
        Should return parsed data, or a `DataAndFiles` object consisting of the
        parsed data and files.
        """
        raise NotImplementedError(".parse() must be overridden.")

从parse方法的注释，也能够看出parse返回的多是解析后的数据，也有多是DataAndFiles对象。

parse方法中的参数：stream即为要解析的数据，

parse_context为须要解析时须要提供的配置，

class DataAndFiles(object):
    def __init__(self, data, files):
        self.data = data
        self.files = files

能够看出DataAndFiles仅仅是data和files的集合。只有MultiPartParser和FileUploadParser才返回DataAndFiles对象。

parser.py一共有如下多种类，JSONParser，YAMLParser，FormParser，MultiPartParser，XMLParser，FileUploadParser。

首先看JSONParser的定义：

class JSONParser(BaseParser):
    """
    Parses JSON-serialized data.
    """

    media_type = 'application/json'

    def parse(self, stream, media_type=None, parser_context=None):
        """
        Parses the incoming bytestream as JSON and returns the resulting data.
        """
        parser_context = parser_context or {}
        encoding = parser_context.get('encoding', settings.DEFAULT_CHARSET)

        try:
            data = stream.read().decode(encoding)
            return json.loads(data)
        except ValueError as exc:
            raise ParseError('JSON parse error - %s' % six.text_type(exc))

经过parse_context获取encoding，而后解码stream，利用json库中的loads方法解析并返回数据。

其实YAMLParser和XMLParser，是跟JSONParser的步骤同样的，只不过调用不一样的库来解析数据。

再来看一下通用的FormPaser，用于解析'application/x-www-form-urlencoded'类型的数据，这种数据是POST方法提交数据，默认的格式。它只不过直接被实例化了QueryDict对象。

class FormParser(BaseParser):
    """
    Parser for form data.
    """

    media_type = 'application/x-www-form-urlencoded'

    def parse(self, stream, media_type=None, parser_context=None):
        """
        Parses the incoming bytestream as a URL encoded form,
        and returns the resulting QueryDict.
        """
        parser_context = parser_context or {}
        encoding = parser_context.get('encoding', settings.DEFAULT_CHARSET)
        data = QueryDict(stream.read(), encoding=encoding)
        return data