JZUG Wiki - ZClassProductHowTo

(cheeseshop 編集中)

プロダクトの作り方について

from ``The Zope Book''
http://www.zope.org/Members/michel/ZB/CustomZopeObjects.dtml

(リンクが切れているんですけど。。。)
プロダクトには、
Pythonスクリプトで書かれたPythonProductと、

Zopeオブジェクトだけで構成されたZClassProductがあります。
- この複合型というのもあります。Pythonのモジュールを呼び出したりシステムを直接扱うような部分はPythonのスクリプトで書き、プレゼンテーションに関する部分は編集しやすいようZClassとする、ということもできます。
ここでは、ZClassProductの作り方を紹介します。

ZClassProductについて

ZClassでプロダクト作る場合、次のような利点があります。
- Zopeオブジェクトを使ってクラスメソッドを記述できる。いきなりコアなZope APIの世界に飛び込まなくても、DTMLやPythonScriptの延長線上でクラスが作れる。
- Zopeのアカウントさえあれば編集できる。1つのプロダクトを複数人で分業するのも簡単（FishBowlを参照）。
逆に、次のような欠点もあります。
- コマンドラインベース・テキストエディタベースの開発は難しい。またFTP経由だとメソッドしか編集できないので、結局Webブラウザに頼るしかない。

ZClassProductの作り方

1. プロダクトを作る

/Control_Panel/Products/フォルダのmanage画面を開き、Add Productsでプロダクトを作る。
プロダクトの編集画面には次のようなタブが表示される。
- Contents
- Properties
- Define Permissions
- Undo
- Find
- Distribution ...
プロダクトはFolderのようになっていて、ContentsタブではDTMLメソッドなどの他、次のようなオブジェクトを作ることができる。
- ZClass ... クラスオブジェクト
  - メソッド、アイコン、プロパティ、パーミッションなどの情報を持つ。
- Permission ... パーミッション項目
  - このオブジェクトを作ると、すべてのパーミッション設定リスト（Security画面）に新しい項目が追加される。
- Factory ... Addリストの項目
  - このオブジェクトを作ると、すべてのオブジェクトリスト（Contents画面の右上にあるセレクタ、Zope2.3以前は右下）に新しいクラス名が追加され、オブジェクトを生成するためのメソッドが呼び出せるようになる。

2. クラスを設計する

プロダクトの中でどんなクラスが必要か、また新しいクラスから作られるオブジェクトがどんなプロパティやメソッドを持つかを決めておく。

3. ZClassオブジェクトを作る

プロダクト内部に移動し、オブジェクトリストから選択してZClassオブジェクトを作る。
Base Classesではベースクラスを指定するが、既存クラスを流用するものでなければ何も指定しなくてもよい。Addボタンを押すと、次にような5つのオブジェクトが同時に作られる。
- クラス名 ... ZClassオブジェクト
- クラス名_add ... コンストラクタメソッド
- クラス名_addForm ... コンストラクタメソッドを呼び出すフォーム
- クラス名_add_permission ... Permissionオブジェクト
- クラス名_factory ... Factoryオブジェクト

4. プロパティシートを定義する

ZClassオブジェクトをクリックすると、そのクラスのプロパティシート編集画面になる。次のようなタブを選んでプロパティシートを編集する。
- Methods ... メソッド
  - ここにはDTMLMethod、PageTemplate、PythonScriptなどを複数置くことができ、オブジェクトに対する操作、あるいは編集画面を定義できる。
- Basic ... メタタイプ名、アイコンなど
- Views ... オブジェクト編集画面のタブ
  - タブをクリックしたとき、どのメソッドを実行するか定義する。既存のものにはContents、View、Properties、Security、Undoといったタブがあるが、ここで新しいタブを定義することもできる。
- Property Sheets ... プロパティシート
  - ここには任意の名前のインスタンス共通プロパティシートを複数置くことが出来る。「Add Instance Common Property Sheet」を押した後は、通常のプロパティ設定画面と同じようにプロパティを追加していく。
  - オブジェクト生成時に持たせたいプロパティは、通常「Basic」という名前のプロパティシートにしておく。
- Permissions ... パーミッション名
- Define Permissions ... オブジェクト操作に対応するパーミッション

5. addメソッドを修正する

クラス名_addメソッドはクラスのコンストラクタメソッドに相当する。
このメソッドでは通常、次の3つの動作が行われる。
- インスタンスの作成
  - createInObjectManagerメソッドでオブジェクトを作る。オブジェクトを作るクラスであれば、当然この1行は必須となる。
- プロパティの設定
  - 自動的に作られるaddメソッドのテンプレートでは、プロパティの設定を行うコードがコメントアウトされている。
  - もしオブジェクトを追加したときにプロパティを設定したい場合はコメントを外し、該当するコード（propertysheets.Basic.manage_edit(REQUEST)）が実行されるように修正する。
- manage画面に戻る
  - addメソッドは、通常はaddFormメソッドから呼び出されてオブジェクトを作る。その後は通常、作ったオブジェクトまたはそれが属するフォルダのmanage画面を表示する。
  - もしaddメソッドをDTMLなどのコードから呼び出して自動的にオブジェクトを作る場合、このリダイレクトを回避しなければならない。
  - そこで、addFormメソッドから「フォームから入力したことが分かるような変数」を渡してやり、addメソッド側でリダイレクトするかしないか判断すれば解決する。
    -

6. addFormメソッドを修正する

クラス名_addFormメソッドはFactoryオブジェクトによってZopeのコアと結びつけられ、manage画面にあるオブジェクトのリストから選んだとき実行される。多くの場合、新しく作るオブジェクトに持たせるプロパティ値を入力するフォームを表示する。
もしオブジェクトを追加するときにID以外のプロパティも一緒に入力するなら、addFormメソッドにフォーム要素を追加しておく。

7. インスタンスを作るなどして、動作確認する

8. 必要なクラスをすべて作る

プロダクト内に持たせるクラスについて、3.〜7.を繰り返す。

Last edited Mon, 11 Sep 2006 01:17:07 +0900 Edit this page