彻底搞懂 SQLAlchemy中的 backref

教程源码截取：

class User(Base):
    __tablename__ = 'user'
    id = Column(Integer, primary_key=True)
    name = Column(String)

   addresses = relationship("Address", backref="user")


class Address(Base):
    __tablename__ = 'address'
    id = Column(Integer, primary_key=True)
    email = Column(String)
    user_id = Column(Integer, ForeignKey('user.id'))

简单来说, relationship函数是sqlalchemy对关系之间提供的一种便利的调用方式, backref参数则对关系提供反向引用的声明。
假如没有relationship，我们只能像下面这样调用关系数据：

＃给定参数User.name,获取该user的addresses
def get_addresses_from_user(user_name):
    user = session.query(User).filter_by(name=user_name).first()
    addresses = session.query(Address).filter_by(user_id=user.id).all()
    return addresses

如果在User中使用relationship定义addresses属性的话，
addresses = relationship(‘Address’)

则我们可以直接在User对象中通过addresses属性获得指定用户的所有地址。
def get_addresses_from_user(user_name):
user = session.query(User).filter_by(name=user_name).first()
return user.addresses

注意，在上面的addresses属性中我们并没有定义backref属性,
所以我们可以通过User对象获取所拥有的地址，但是不能通过Address对象获取到所属的用户.

>>> u = User()
>>> u.addresses
[]
>>> a = Address()
>>> a.user
Traceback (most recent call last):
  File "", line 1, in 
AttributeError: 'Address' object has no attribute 'user'

但是当我们有从Address对象获取所属用户的需求时，backref参数就派上用场了。

addresses = relationship('Address', backref='user')


>>> a = Address()
>>> a.user

大致原理应该就是：

sqlalchemy在运行时对Address对象动态的设置了一个指向所属User对象的属性，

这样就能在实际开发中使逻辑关系更加清晰，代码更加简洁了。

一言以蔽之:

backref用于在关系另一端的类中快捷地创建一个指向当前类对象的属性。