首页 > 代码库 > [python] ORM 第一次注释

[python] ORM 第一次注释

不懂的东西还太多,就当是自己监督自己吧

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

__author__ = Michael Liao

import asyncio, logging

import aiomysql

def log(sql, args=()):
    logging.info(SQL: %s % sql)
#用来打印sql的?args没有用到。

async def create_pool(loop, **kw):
    # 建立一个异步io的连接池
    logging.info(create database connection pool...)
    # logging 的东西只是打印日志的
    global __pool
    # 这个pool的即使全局变量,他又想不让其他人调用
    # 创建的方法就是 aiomysql.create_pool
    #kw的得取方法倒是知道了,it is kw.get(‘host‘,‘default‘)
    #if do not have defaultvalue, just kw[‘port‘]
    __pool = await aiomysql.create_pool(
        host=kw.get(host, localhost),
        port=kw.get(port, 3306),
        user=kw[user],
        password=kw[password],
        db=kw[db],
        charset=kw.get(charset, utf8),
        autocommit=kw.get(autocommit, True),
        maxsize=kw.get(maxsize, 10),
        minsize=kw.get(minsize, 1),
        loop=loop
        #这个 loop = loop get不到。
    )

async def select(sql, args, size=None):
    # all the opreating nead the asyncio
    log(sql, args)
    # 这个以后已经拼接好了???
    global __pool
    async with __pool.get() as conn:
        #连接上,然后使用这个连接的get方法,as 为conn
        async with conn.cursor(aiomysql.DictCursor) as cur:
            #使用conn的 cursor AS 为 cur
            await cur.execute(sql.replace(?, %s), args or ())
            #游标执行占位符转换 ‘?’ → ‘%s’
            if size:
                #这个 size 哪里来的啊???
                #大哥,上边的size已经定义出来了。
                #None 就和False一样
                rs = await cur.fetchmany(size)
            else:
                rs = await cur.fetchall()
        logging.info(rows returned: %s % len(rs))
        #这里就是返回值了
        return rs
        # rs 就是这个rows

async def execute(sql, args, autocommit=True):
    log(sql)
    #这里就是sql中的执行,好像还不是commit
    async with __pool.get() as conn:
        #仍然是用实例化出来的__pool 的get函数来建立一个连接 conn
        if not autocommit:
            #不太清楚在什么情况下这个autocommit 会 = False
            await conn.begin()
        try:
            async with conn.cursor(aiomysql.DictCursor) as cur:
                #还是用连接创建游标
                await cur.execute(sql.replace(?, %s), args)
                #替换cursor的占位符
                affected = cur.rowcount
            if not autocommit:
                #这个 atuocommit的作用还是没明白
                await conn.commit()
        except BaseException as e:
            if not autocommit:
                await conn.rollback()
            raise
        return affected

def create_args_string(num):
    #创建评论参数字符串???
    L = []
    for n in range(num):
        L.append(?)
    return , .join(L)

class Field(object):
    #类型的被继承类

    def __init__(self, name, column_type, primary_key, default):
        self.name = name
        self.column_type = column_type
        self.primary_key = primary_key
        self.default = default

    def __str__(self):
        return <%s, %s:%s> % (self.__class__.__name__, self.column_type, self.name)

class StringField(Field):
    #字符,全都继承了Field

    def __init__(self, name=None, primary_key=False, default=None, ddl=varchar(100)):
        super().__init__(name, ddl, primary_key, default)

class BooleanField(Field):
    #布尔

    def __init__(self, name=None, default=False):
        super().__init__(name, boolean, False, default)

class IntegerField(Field):
    #整型

    def __init__(self, name=None, primary_key=False, default=0):
        super().__init__(name, bigint, primary_key, default)

class FloatField(Field):
    #浮点

    def __init__(self, name=None, primary_key=False, default=0.0):
        super().__init__(name, real, primary_key, default)

class TextField(Field):
    #文本

    def __init__(self, name=None, default=None):
        super().__init__(name, text, False, default)

class ModelMetaclass(type):
    #继承type

    def __new__(cls, name, bases, attrs):
        # 这应该是新建方法
        if name==Model:
            return type.__new__(cls, name, bases, attrs)
        #如果name 为 Model 我直接return type的 new方法???
        tableName = attrs.get(__table__, None) or name
        # 这个attr 是和**kw 的get 是一个意思吗??
        logging.info(found model: %s (table: %s) % (name, tableName))
        #打印这个table
        mappings = dict()
        #把mappings 定义出来[]
        fields = []
        primaryKey = None
        #一直没太明白这个 primaryKey 的含义。
        for k, v in attrs.items():
            # attr的 type是??
            if isinstance(v, Field):
                logging.info(  found mapping: %s ==> %s % (k, v))
                mappings[k] = v
                #用mappings 建立这个k v 的对应关系
                if v.primary_key:
                    # 找到主键: fengge的注释
                    #这里要处理我前边是for 出来的
                    if primaryKey:
                        #也就是说我这里默认不raise这个Error
                        raise StandardError(Duplicate primary key for field: %s % k)
                        #!!!不知道为啥我这里的StandardError 报错了。
                    primaryKey = k
                    #这个时候我的 primaryKey 复制为k 就好比id
                else:
                    fields.append(k)
                    #如果不是主键,就简单的append进去
                    #但是主键好像没有被append啊
        if not primaryKey:
            raise StandardError(Primary key not found.)
            # !!!不知道为啥我这里的StandardError 报错了。
            #这里我看明白了,就是没找到主键
        for k in mappings.keys():
            attrs.pop(k)
            #这里为啥要把attrs里边的k pop出来?
            #而且mappings.key??? 还只有这两个地方有
        escaped_fields = list(map(lambda f: `%s` % f, fields))
        #这里是将fields 里边的所有sql 都给处理成 `sql` ??
        #明白了,attrs是dict
        attrs[__mappings__] = mappings # 保存属性和列的映射关系
        attrs[__table__] = tableName
        attrs[__primary_key__] = primaryKey # 主键属性名
        attrs[__fields__] = fields # 除主键外的属性名
        attrs[__select__] = select `%s`, %s from `%s` % (primaryKey, , .join(escaped_fields), tableName)
        attrs[__insert__] = insert into `%s` (%s, `%s`) values (%s) % (tableName, , .join(escaped_fields), primaryKey, create_args_string(len(escaped_fields) + 1))
        attrs[__update__] = update `%s` set %s where `%s`=? % (tableName, , .join(map(lambda f: `%s`=? % (mappings.get(f).name or f), fields)), primaryKey)
        attrs[__delete__] = delete from `%s` where `%s`=? % (tableName, primaryKey)
        # 这是他们的4个基础语句  那 left join 哪些呢??
        return type.__new__(cls, name, bases, attrs)

class Model(dict, metaclass=ModelMetaclass):
    #实例化Model 的时候 也顺带着将ModelMetaclass 也实例化出来了?

    def __init__(self, **kw):
        super(Model, self).__init__(**kw)
        #这里是说继承父类的所有参数吗?

    def __getattr__(self, key):
        try:
            return self[key]
            #getattr的时候return
        except KeyError:
            raise AttributeError(r"‘Model‘ object has no attribute ‘%s‘" % key)

    def __setattr__(self, key, value):
        self[key] = value
        #set的时候直接把value也传过来了。

    def getValue(self, key):
        return getattr(self, key, None)

    def getValueOrDefault(self, key):
        value = getattr(self, key, None)
        if value is None:
            field = self.__mappings__[key]
            #如果是空就mappings??
            if field.default is not None:
                value = field.default() if callable(field.default) else field.default
                #如果不是空 就置给value
                logging.debug(using default value for %s: %s % (key, str(value)))
                setattr(self, key, value)
                #然后还要setattr
        return value

    @classmethod
    async def findAll(cls, where=None, args=None, **kw):
         find objects by where clause. 
        sql = [cls.__select__]
        if where:
            sql.append(where)
            sql.append(where)
            #这里是处理where语句的??
        if args is None:
            args = []
        orderBy = kw.get(orderBy, None)
        if orderBy:
            sql.append(order by)
            sql.append(orderBy)
            #处理 orderby?
        limit = kw.get(limit, None)
        if limit is not None:
            sql.append(limit)
            #这里的limit 是啥啊。。。
            if isinstance(limit, int):
                sql.append(?)
                args.append(limit)
            elif isinstance(limit, tuple) and len(limit) == 2:
                sql.append(?, ?)
                args.extend(limit)
            else:
                raise ValueError(Invalid limit value: %s % str(limit))
        rs = await select( .join(sql), args)
        return [cls(**r) for r in rs]

    @classmethod
    async def findNumber(cls, selectField, where=None, args=None):
         find number by select and where. 
        #为了查找什么number呢?
        sql = [select %s _num_ from `%s` % (selectField, cls.__table__)]
        if where:
            sql.append(where)
            sql.append(where)
        rs = await select( .join(sql), args, 1)
        if len(rs) == 0:
            return None
        return rs[0][_num_]

    @classmethod
    async def find(cls, pk):
         find object by primary key. 
        rs = await select(%s where `%s`=? % (cls.__select__, cls.__primary_key__), [pk], 1)
        if len(rs) == 0:
            return None
        return cls(**rs[0])

    async def save(self):
        args = list(map(self.getValueOrDefault, self.__fields__))
        args.append(self.getValueOrDefault(self.__primary_key__))
        rows = await execute(self.__insert__, args)
        if rows != 1:
            logging.warn(failed to insert record: affected rows: %s % rows)

    async def update(self):
        args = list(map(self.getValue, self.__fields__))
        args.append(self.getValue(self.__primary_key__))
        rows = await execute(self.__update__, args)
        if rows != 1:
            logging.warn(failed to update by primary key: affected rows: %s % rows)

    async def remove(self):
        args = [self.getValue(self.__primary_key__)]
        rows = await execute(self.__delete__, args)
        if rows != 1:
            logging.warn(failed to remove by primary key: affected rows: %s % rows)

 

[python] ORM 第一次注释