萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python Pylons 框架整合 MongoDB 實戰:Ming ODM 配置、模型定義與初始化資料

前言:Pylons + MongoDB 架構選型

Pylons 1.0 提供高度可組裝的 WSGI 架構,Model 層**不綁定 ORM**。MongoDB 文件導向特性與 Python 字典天然契合。本文採用 **Ming ODM** (SourceForge 團隊開發,API 類 SQLAlchemy) 示範完整整合流程,並說明替代方案 MongoKit、Motor (非同步)、原生 PyMongo。

專案結構

MyProject/
├── config/
│   ├── environment.py      # 應用啟動初始化
│   └── middleware.py
├── model/
│   ├── __init__.py         # Ming 模型定義、Session 管理
│   └── mongo.py            # (可選) 連線工具
├── websetup.py             # 部署時初始化資料
├── development.ini         # 開發環境設定
└── ...

1. model/__init__.py — 核心模型定義

# -*- coding: utf-8 -*-
"""MongoDB 模型定義與 Ming Session 管理"""

from ming import Session, schema
from ming.orm import MappedClass, FieldProperty, ForeignIdProperty, RelationProperty
from ming.orm import ThreadLocalORMSession

# 全域 Session (ThreadLocal,請求隔離)
session = None

def init_single_model(model_class):
    """將模型類別綁定到全域 session"""
    model_class.__mongometa__.session = session

class Page(MappedClass):
    """範例文件:頁面內容"""
    class __mongometa__:
        session = session          # 將在 init_model 時注入
        name = 'pages'             # Collection 名稱
        # indexes = [ ... ]        # 可在此定義索引

    _id = FieldProperty(schema.ObjectId)  # MongoDB _id
    title = FieldProperty(str)
    content = FieldProperty(str)

    # 關聯範例 (若需要)
    # author_id = ForeignIdProperty('User')
    # author = RelationProperty('User')

def init_model(engine):
    """應用啟動時呼叫:建立 ThreadLocal Session、綁定所有模型、編譯映射"""
    global session
    session = ThreadLocalORMSession(doc_session=Session(engine))

    # 逐一綁定模型
    init_single_model(Page)
    # init_single_model(User)
    # init_single_model(Comment)

    # 完成映射編譯 (建立索引、驗證 schema)
    MappedClass.compile_all()

# 便利函數:取得當前請求的 session
def get_session():
    return session

2. config/environment.py — 應用啟動掛載

# -*- coding: utf-8 -*-
"""Pylons 環境初始化:資料庫引擎、模板、路由..."""

from ming.datastore import DataStore
from myproject.model import init_model

def load_environment(global_conf, app_conf):
    # ... 既有 Mako、路由、靜態檔案設定 ...

    # ===== MongoDB 連線 =====
    # development.ini 範例:database.uri = mongodb://localhost:27017/myproject
    db_uri = app_conf.get('database.uri', 'mongodb://localhost:27017/myproject')
    engine = DataStore(db_uri)

    # 初始化 Ming 模型層
    init_model(engine)

    # ... 其他初始化 ...
    return config

3. development.ini — 設定檔

[app:main]
use = egg:MyProject
pyramid.reload_templates = true
pyramid.debug_authorization = false
pyramid.debug_notfound = false
pyramid.debug_routematch = false
pyramid.default_locale_name = en
pyramid.includes = pyramid_debugtoolbar

# ===== MongoDB =====
database.uri = mongodb://localhost:27017/myproject

# ===== Ming 選項 (可選) =====
# ming.auto_create_indexes = true
# ming.ensure_indexes = true

4. websetup.py — 部署初始化資料

# -*- coding: utf-8 -*-
"""應用安裝/升級時執行:建立索引、植入預設資料"""

import logging
import pylons.test
from myproject.config.environment import load_environment
from myproject import model

log = logging.getLogger(__name__)

def setup_app(command, conf, vars):
    # 避免測試環境重複載入
    if not pylons.test.pylonsapp:
        load_environment(conf.global_conf, conf.local_conf)

    log.info("建立示範資料...")
    # 使用 Ming session 寫入
    page = model.Page(title='歡迎頁面', content='這是第一筆 MongoDB 文件。')
    model.session.flush()  # 同步寫入 MongoDB
    log.info("示範資料建立完成。")

5. 控制器使用範例

# controllers/page.py
import logging
from pylons import request, response, session, tmpl_context as c
from myproject.lib.base import BaseController, render
from myproject.model import Page, get_session

log = logging.getLogger(__name__)

class PageController(BaseController):
    def index(self):
        # 查詢所有頁面
        c.pages = get_session().query(Page).find().all()
        return render('/page/index.mako')

    def create(self):
        title = request.params.get('title')
        content = request.params.get('content')
        if title and content:
            page = Page(title=title, content=content)
            get_session().flush()
            return redirect(url('page_index'))
        return render('/page/create.mako')

替代方案快速比較

方案特點適用場景
Ming ODMSQLAlchemy 風格、聲明式 schema、關聯支援、ThreadLocal session傳統同步 Web、團隊熟悉 SQLAlchemy
MongoKit輕量、結構驗證、支援 dot notation、PyMongo 直接封裝簡單專案、偏好動態 schema
Motor (Async)非阻塞、Tornado/asyncio 整合、高併發異步框架
原生 PyMongo零依賴、效能最高、完全控制微服務、底層工具、不想要 ORM

生產環境檢查清單

  • 連線池:DataStore(uri, max_pool_size=100)。
  • 索引管理:mongometa__.indexes = [('title', 1), ('created_at', -1)],部署時 ensure_indexes()。
  • 寫入關切:session.safe = True (預設) 或 w=majority。
  • 讀取偏好:從節點讀取 read_preference=ReadPreference.SECONDARY_PREFERRED。
  • 監控:db.serverStatus()、db.currentOp()、慢查詢日誌。

結語

Pylons + MongoDB + Ming 形成 **「鬆耦合、高擴展、文件導向」** 的現代 Web 堆疊。關鍵在於:**ThreadLocal Session 隔離請求**、**聲明式模型定義**、**啟動期編譯映射**、**部署腳本植入種子資料**。掌握此模式,即可在關係型資料庫之外,構建高彈性的文件型應用。

copyright © 萬盛學電腦網 all rights reserved