tornado架构分析3 options.py中基础类_Option

1 数据清洗

option里面最重要的方法就是parse，在这里，parse函数的一开始就调用了后面的子函数_parse_datetime，_parse_timedelta，_parse_bool，_parse_string。经过我分割，查找具体函数执行情况，这四个函数其实是清理格式的，为了防止格式混乱，导致后期处理困难。就用它们做了格式清洗。

     def parse(self, value):
         _parse = {
             datetime.datetime: self._parse_datetime,
             datetime.timedelta: self._parse_timedelta,
             bool: self._parse_bool,
             basestring_type: self._parse_string,
         }.get(self.type, self.type)

 注：parse函数的部分内容

（1）时间格式数据清洗

     # Supported date/time formats in our options
     _DATETIME_FORMATS = [
         "%a %b %d %H:%M:%S %Y",
         "%Y-%m-%d %H:%M:%S",
         "%Y-%m-%d %H:%M",
         "%Y-%m-%dT%H:%M",
         "%Y%m%d %H:%M:%S",
         "%Y%m%d %H:%M",
         "%Y-%m-%d",
         "%Y%m%d",
         "%H:%M:%S",
         "%H:%M",
     ]

     def _parse_datetime(self, value):
         for format in self._DATETIME_FORMATS:
             try:
                 return datetime.datetime.strptime(value, format)
             except ValueError:
                 pass
         raise Error('Unrecognized date/time format: %r' % value)

这个列表是有讲究的，从列表顺序自上而下进行匹配。

当匹配成功后，就返回一个标准值。如果匹配失败，就返回一个ValueError。因此，原作者在这里对ValueError做了一个异常处理。

如果全部都匹配失败，那么久返回一个错误，证明时间参数的确有问题了。

以下部分是我做的一个匹配失败报错的情况：

 >>> datetime.datetime.strptime("19:20:20", "%H:%M")
 Traceback (most recent call last):
   File "<stdin>", line 1, in <module>
   File "C:\Python27\lib\_strptime.py", line 328, in _strptime
     data_string[found.end():])
 ValueError: unconverted data remains: :20

（2） unix时间模式的数据清洗

我们都知道，程序中表示时间还有一种方式是unix时间戳，大意就是从1970年开始，已经执行的秒数。

这部分，我没有细看，不过简单分析，应该就是时间模式的一个替换

     _TIMEDELTA_ABBREV_DICT = {
         'h': 'hours',
         'm': 'minutes',
         'min': 'minutes',
         's': 'seconds',
         'sec': 'seconds',
         'ms': 'milliseconds',
         'us': 'microseconds',
         'd': 'days',
         'w': 'weeks',
     }

     _FLOAT_PATTERN = r'[-+]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][-+]?\d+)?'

     _TIMEDELTA_PATTERN = re.compile(
         r'\s*(%s)\s*(\w*)\s*' % _FLOAT_PATTERN, re.IGNORECASE)

     def _parse_timedelta(self, value):
         try:
             sum = datetime.timedelta()
             start = 0
             while start < len(value):
                 m = self._TIMEDELTA_PATTERN.match(value, start)
                 if not m:
                     raise Exception()
                 num = float(m.group(1))
                 units = m.group(2) or 'seconds'
                 units = self._TIMEDELTA_ABBREV_DICT.get(units, units)
                 sum += datetime.timedelta(**{units: num})
                 start = m.end()
             return sum
         except Exception:
             raise

（3）  bool值的数据清洗

这部分是用一个判断来做的，根据判断结果，自然而然就将不规范的bool值（如true,false）转成规范的bool值了

这里函数我提取出来并测试了一下，是成功的，但是我没有搞明白实际的原理。

     def _parse_bool(self, value):
         return value.lower() not in ("false", "", "f")

（4）  字符串变量的数据清洗

这部分就没啥好说的了，大意就是把str等都转成unicode

     def _parse_string(self, value):
         return _unicode(value)