mongoengine.md

** Xiang Wang @ 2016-07-13 15:47:54 **

mongoengine 官网

• 字段

基础

• example

  from mongoengine import *
  connect('tumblelog')
  connect('mongodb', host='mac', port=27017)
  
  class User(Document):
      name = StringField(required=True)
  
  class User_embedded(EmbeddedDocument):
      name = StringField(required=True)
  

数据格式

• StringField() # 字符串
  1. max_length # 设置最长多少, 超过就会报错, 类似meta, 是python层面
  2. primary_key=True # 设置为主键，数据库里面的_id就会是这个值
  3. required=True # 能否为空, 如果为空，保存的时候就不保存
  4. default='we' # 创建新的对象，属性就是'we'，而不是None
• ReferenceField(User) # 保存了reference的 ObjectId
• EmbeddedDocumentField(User_embedded) # 保存了所有的信息
• URLField()
  1. verify_exists=False # True 每次保存都会检查url
• ListField(EmbeddedDocumentField(models))
  • 不管有没有 default = [],默认的都是 [] 而不是None
  • 删除或者添加里面的数据

    page.update_one(pull__authors=bob)
    page.update_one(push_authors=bob)
    

• ObjectIdField
  • 自定义一个数据的id:

    import bson
    object_id = bson.objectid.ObjectId()
    read = Read(id=object_id)
    read.save()
    assert read.id == object_id

  • str(object) 返回他的id的字符串

数据更新

class.update(inc__filed=3)  # 原子操作，多线程使用

特殊的自定义方法

clean(self):  # 每次save的时候都会调用这个，用来写数据格式的正确与否
    if '@' in self.name: # 如果数据格式不正确
        raise ValidationError('There should not be @ in your name') # 则 `raise ValidationError('message')`

数据查询

Book.objects(language='Eng')
Book.objects(author__name='wangx')
User.objects(name='wangx').fields(slice__addresses=[0,1])
User.objects(friends__contains='Lily').all()

其他类

DynamicDocument:    # 如果数据库里面的数据无法正确解析到class(比如多了一个字段，就会报错。使用DynamicDocument就能解决这个问题)