通过 MongoEngine 使用 MongoDB
使用一个 MongoDB 之类的文档型数据库来代替关系 SQL 数据是很常见的。本方 案演示如何使用文档映射库 MongoEngine 来集成 MongoDB 。
先准备好一个运行中的 MongoDB 服务和 Flask-MongoEngine
1. pip install flask-mongoengine
配置
基本的配置是在 app.config 中定义 MONGODB_SETTINGS 并创建一个 MongoEngine 实例:
1. from flask import Flask
2. from flask_mongoengine import MongoEngine
4. app = Flask(__name__)
5. app.config['MONGODB_SETTINGS'] = {
6. "db": "myapp",
7. }
8. db = MongoEngine(app)
映射文档
声明用于一个 Mongo 文档的模型的方法是创建一个 Document 的子类,然后 声明每个字段:
1. import mongoengine as me
3. class Movie(me.Document):
4. title = me.StringField(required=True)
5. year = me.IntField()
6. rated = me.StringField()
7. director = me.StringField()
8. actors = me.ListField()
如果文档包含嵌套的字段,那么使用 EmbeddedDocument 来定义嵌套的文 档,并在父文档中使用 EmbeddedDocumentField 声明相应的字段:
1. class Imdb(me.EmbeddedDocument):
2. imdb_id = me.StringField()
3. rating = me.DecimalField()
4. votes = me.IntField()
6. class Movie(me.Document):
7. ...
8. imdb = me.EmbeddedDocumentField(Imdb)
创建数据
使用字段的关键字参数实例化文档类。还可以在实例化后为字段属性指定值。 然后调用 doc.save()
1. bttf = Movie(title="Back To The Future", year=1985)
2. bttf.actors = [
3. "Michael J. Fox",
4. "Christopher Lloyd"
5. ]
6. bttf.imdb = Imdb(imdb_id="tt0088763", rating=8.5)
7. bttf.save()
查询
使用类的 objects 属性来执行查询。关键字参数用于字段的等值查询:
1. bttf = Movies.objects(title="Back To The Future").get_or_404()
字段名称后加双下划线可以连接查询操作符。 objects 及其返回的查询是可迭代的:
1. some_theron_movie = Movie.objects(actors__in=["Charlize Theron"]).first()
3. for recents in Movie.objects(year__gte=2017):
4. print(recents.title)
相关文档
有许多关于使用 MongoEngine 定义和查询文档数据的方法,更多信息请参阅其 官方文档 。
Flask-MongoEngine 为 MongoEngine 添加了有用的工具,请参阅其 文档说明 。
