前文列表

扩展阅读

前期准备

在实现多对多之前，我们还需要先增加一个评论(Comment) models class，而且 Comment 是 Post 的关系是 one to many。

首先依旧是在 models.py 中定义模型类：

class Post(db.Model):    """Represents Proected posts."""    __tablename__ = 'posts'    id = db.Column(db.String(45), primary_key=True)    title = db.Column(db.String(255))    text = db.Column(db.Text())    publish_date = db.Column(db.DateTime)    # Set the foreign key for Post    user_id = db.Column(db.String(45), db.ForeignKey('users.id'))    # Establish contact with Comment's ForeignKey: post_id    comments = db.relationship(        'Comment',        backref='posts',        lazy='dynamic')    def __init__(self, title):        self.title = title    def __repr__(self):        return "
     
      ".format(self.title)class Comment(db.Model):    """Represents Proected comments."""    __tablename__ = 'comments'    id = db.Column(db.String(45), primary_key=True)    name = db.Column(db.String(255))    text = db.Column(db.Text())    date = db.Column(db.DateTime())    post_id = db.Column(db.String(45), db.ForeignKey('posts.id'))    def __init__(self, name):        self.name = name    def __repr__(self):        return '
      
       '.format(self.name)

然后要记住在 manage.py 中返回 Comment

def make_shell_context():    """Create a python CLI.    return: Default import object    type: `Dict`    """    return dict(app=main.app,                db=models.db,                User=models.User,                Post=models.Post,                Comment=models.Comment)

最后在 manager shell 验证是否成功导入了 Comment

(env) [root@flask-dev JmilkFan-s-Blog]# python manage.py shell>>> Comment

多对多

如果我们有两个 models，它们之间是相互引用的，而且彼此都可以相互引用对方的多个对象。这就是所谓 many to many 的关系类型。

多对多关系会在两个类之间增加一个关联表。这个关联的表在 relationship() 方法中通过 secondary 参数来表示。通常的，这个表会通过 MetaData 对象来与声明基类关联，所以这个 ForeignKey 指令会使用链接来定位到远程的表：

posts_tags = db.Table('posts_tags',    db.Column('post_id', db.String(45), db.ForeignKey('posts.id')),    db.Column('tag_id', db.String(45), db.ForeignKey('tags.id')))class Post(db.Model):    """Represents Proected posts."""    __tablename__ = 'posts'    id = db.Column(db.String(45), primary_key=True)    title = db.Column(db.String(255))    text = db.Column(db.Text())    publish_date = db.Column(db.DateTime)    # Set the foreign key for Post    user_id = db.Column(db.String(45), db.ForeignKey('users.id'))    # Establish contact with Comment's ForeignKey: post_id    comments = db.relationship(        'Comment',        backref='posts',        lazy='dynamic')    # many to many: posts <==> tags    tags = db.relationship(        'Tag',        secondary=posts_tags,        backref=db.backref('posts', lazy='dynamic'))    def __init__(self, title):        self.title = title    def __repr__(self):        return "
     
      ".format(self.title)class Tag(db.Model):    """Represents Proected tags."""    __tablename__ = 'tags'    id = db.Column(db.String(45), primary_key=True)    name = db.Column(db.String(255))    def __init__(self, name):        self.name = name    def __repr__(self):        return "
      
       ".format(self.name)

many to many 的关系仍然是由 db.relationship() 来定义

seconddary(次级)：会告知 SQLAlchemy 该 many to many 的关联保存在 posts_tags 表中

backref：声明表之间的关系是双向，帮助手册 help(db.backref)。需要注意的是：在 one to many 中的 backref 是一个普通的对象，而在 many to many 中的 backref 是一个 List 对象。

NOTE 1：实际上 db.Table 对象对数据库的操作比 db.Model 更底层一些。后者是基于前者来提供的一种对象化包装，表示数据库中的一条记录。 posts_tags 表对象之所以使用 db.Table 不使用 db.Model 来定义，是因为我们不需要对 posts_tags (self.name)进行直接的操作(不需要对象化)，posts_tags 代表了两张表之间的关联，会由数据库自身来进行处理。

NOTE 2： posts_tags 的声明定义最好在 Post 和 Tag 之前。

NOTE 3: 没添加一个 models class 都要记得在 manage.py 中导入并返回，方便之后的调试，这里就不作重复了。

同步数据库

(env) [root@flask-dev JmilkFan-s-Blog]# python manage.py shell>>> db.create_all()

使用样例

>>> posts = db.session.query(Post).all()>>> posts[
     
      , 
      
       ]>>> post_one = posts[1]>>> post_two = posts[0]# 实例化 3 个 Tag 的对象>>> from uuid import uuid4>>> tag_one = Tag('JmilkFan')>>> tag_one.id = str(uuid4())>>> tag_two = Tag('FanGuiju')>>> tag_two.id = str(uuid4())>>> tag_three = Tag('Flask')>>> tag_three.id = str(uuid4())# 将 Tag 的实例化对象赋值给 Post 实例化对象的 tags 属性# 即指定 Tag 和 Post 之间的关联状态# post_one 对应一个 tag# post_two 对应三个 tags# tag_one/tag_three 对应一个 post# tag_two 对象两个 posts>>> post_one.tags[]>>> post_one.tags = [tag_two]>>> post_two.tags = [tag_one, tag_two, tag_three]

NOTE：此时的数据库中还是只有原来就已经存在的两条 posts 记录，但是还没有 tags 记录。这是因为在刚刚实例化的 Tag 对象还没有被提交，所以不会被写入到数据库中。

mysql> select * from posts;+--------------------------------------+-------------+------+--------------+--------------------------------------+| id                                   | title       | text | publish_date | user_id                              |+--------------------------------------+-------------+------+--------------+--------------------------------------+| 0722c107-296f-4ac5-8133-48f3470d85ca | Second Post | NULL | NULL         | ad7fd192-89d8-4b53-af96-fceb1f91070f || 140078fe-c53b-4226-ad47-33734793e47e | First Post  | NULL | NULL         | ad7fd192-89d8-4b53-af96-fceb1f91070f |+--------------------------------------+-------------+------+--------------+--------------------------------------+2 rows in set (0.00 sec)mysql> select * from tags;Empty set (0.00 sec)

NOTE：再次提交 post_one/post_two 对象。post_one/post_two 对象相应的记录本就已经存在于数据库中了为什么要重新提交呢？

这是因为 post_one/post_two 都被指定了新的关联属性 tags，所以提交 post_one/post_two 不仅仅是更新 posts 的引用，更重要的是将新创建的 3 个 tags 对象写入到数据库中，同时也是将 posts 和 tags 的映射关系写入到 posts_tags 表中。

>>> db.session.add(post_one)>>> db.session.add(post_two)>>> db.session.commit()

再次查看数据库：

mysql> select * from tags;+--------------------------------------+----------+| id                                   | name     |+--------------------------------------+----------+| 22c46fa9-6899-4851-b95b-cc6267b68c7c | FanGuiju || 2a3f5c3f-1e1b-4d4a-89c6-62ea74fed75e | JmilkFan || 76b38f31-6a23-4acd-b252-fc580e46d186 | Flask    |+--------------------------------------+----------+3 rows in set (0.00 sec)mysql> select * from posts_tags;+--------------------------------------+--------------------------------------+| post_id                              | tag_id                               |+--------------------------------------+--------------------------------------+| 140078fe-c53b-4226-ad47-33734793e47e | 22c46fa9-6899-4851-b95b-cc6267b68c7c || 0722c107-296f-4ac5-8133-48f3470d85ca | 76b38f31-6a23-4acd-b252-fc580e46d186 || 0722c107-296f-4ac5-8133-48f3470d85ca | 2a3f5c3f-1e1b-4d4a-89c6-62ea74fed75e || 0722c107-296f-4ac5-8133-48f3470d85ca | 22c46fa9-6899-4851-b95b-cc6267b68c7c |+--------------------------------------+--------------------------------------+4 rows in set (0.00 sec)

NOTE：在上面说过了 many to many 的 backref 是一个 List 对象，所以我们还可以反过来为 tags 添加一个 posts 对象(引用)。

>>> tag_one.posts.all()[
     
      ]>>> tag_one.posts.append(post_one)>>> tag_one.posts.all()[
      
       , 
       
        ]>>> post_one.tags[
        
         , 
         
          ]# 因为修改了 tag_one 的 posts 属性(添加了 post_one 的引用)，所以需要重新提交 tag_one 才会被写入到数据库。>>> db.session.add(tag_one)>>> db.session.commit()

再次查看数据库的记录：

mysql> select * from tags;+--------------------------------------+----------+| id                                   | name     |+--------------------------------------+----------+| 22c46fa9-6899-4851-b95b-cc6267b68c7c | FanGuiju || 2a3f5c3f-1e1b-4d4a-89c6-62ea74fed75e | JmilkFan || 76b38f31-6a23-4acd-b252-fc580e46d186 | Flask    |+--------------------------------------+----------+3 rows in set (0.00 sec)mysql> select * from posts;+--------------------------------------+-------------+------+--------------+--------------------------------------+| id                                   | title       | text | publish_date | user_id                              |+--------------------------------------+-------------+------+--------------+--------------------------------------+| 0722c107-296f-4ac5-8133-48f3470d85ca | Second Post | NULL | NULL         | ad7fd192-89d8-4b53-af96-fceb1f91070f || 140078fe-c53b-4226-ad47-33734793e47e | First Post  | NULL | NULL         | ad7fd192-89d8-4b53-af96-fceb1f91070f |+--------------------------------------+-------------+------+--------------+--------------------------------------+2 rows in set (0.00 sec)mysql> select * from posts_tags;+--------------------------------------+--------------------------------------+| post_id                              | tag_id                               |+--------------------------------------+--------------------------------------+| 140078fe-c53b-4226-ad47-33734793e47e | 22c46fa9-6899-4851-b95b-cc6267b68c7c || 0722c107-296f-4ac5-8133-48f3470d85ca | 76b38f31-6a23-4acd-b252-fc580e46d186 || 0722c107-296f-4ac5-8133-48f3470d85ca | 2a3f5c3f-1e1b-4d4a-89c6-62ea74fed75e || 0722c107-296f-4ac5-8133-48f3470d85ca | 22c46fa9-6899-4851-b95b-cc6267b68c7c || 140078fe-c53b-4226-ad47-33734793e47e | 2a3f5c3f-1e1b-4d4a-89c6-62ea74fed75e |+--------------------------------------+--------------------------------------+5 rows in set (0.00 sec)

NOTE: 从 posts_tags 的记录中可以看出 posts 和 tags 之间的多对多关系。

获取文章 First Post 下有哪些标签：

>>> db.session.query(Post).filter_by(title='First Post').first().tags[
     
      , 
      
       ]

获取标签 JmilkFan 下有哪些文章

>>> db.session.query(Tag).filter_by(name='JmilkFan').first().posts.all()[
     
      , 
      
       ]

NOTE：再次说明一下，在定义 models 间关系时使用的 backref 参数，指定了加载关联对象的方式(这里使用了动态方式)，所以加载 Tag 的关联对象 Post 时，返回的是 sqlalchemy.orm.dynamic.AppenderBaseQuery object 而不是全部的关联对象。

那么为什么反之却是直接返回全部的关联对象呢？

这是因为我们是在 Post 中使用了 backref 对象，所以对于两者的关系而言，backref 指的是 Tag。

>>> db.session.query(Post).filter_by(title='First Post').first().tags[
     
      , 
      
       ]>>> db.session.query(Tag).filter_by(name='JmilkFan').first().posts

一直在使用的 session

session 是连接到数据库的一个桥梁，实际上 session 具有更多的功能，例如：事务。

事务：是对数据库进行操作即集合，在我们 commit 的时候，实际事务帮我们实现了一系列有效的数据库操作。

例如：刚刚我们在 commit 一个 post_one/post_two 前，明明没有 commit tag_one/tag_two/tag_three，为什么数据库中还会写入这三条记录呢？这些都是由事务去帮我们进行的隐式的数据库操作。如果没有事务我们就需要按部就班一步步的完成对数据库的写入，这样的效率是非常低的。除此之外 SQLAlchemy 的 session 还会提供很多有用的功能，感兴趣的话可以继续挖掘，这里就不多做介绍了。

目录

前文列表

扩展阅读

前期准备

多对多

使用样例

一直在使用的 session