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 # 開發環境設定
└── ...
# -*- 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
# -*- 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
[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
# -*- 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("示範資料建立完成。")
# 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 ODM | SQLAlchemy 風格、聲明式 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 隔離請求**、**聲明式模型定義**、**啟動期編譯映射**、**部署腳本植入種子資料**。掌握此模式,即可在關係型資料庫之外,構建高彈性的文件型應用。