まずは抽象クラスから。
Factoryクラスです。
abstractfactory/factory/Factory.php

 
<?php
namespace abstractfactory\factory;
 
/**
 * Abstract Factory
 * @author $Author$
 *
 */
abstract class Factory {
    /**
     * Factory type 1
     * @var integer
     */
    const TYPE_1 = 1;
 
    /**
     * Factory type 2
     * @var integer
     */
    const TYPE_2 = 2;
 
    /**
     * Return factory
     * @return Factory
     */
    public static function getFactory($type) {
        if($type == self::TYPE_1) {
            return new ConcreteFactory1();
        } else if($type == self::TYPE_2) {
            return new ConcreteFactory2();
        }
        throw new \Exception('Argument of ' . __CLASS__ . '::' . __METHOD__ . '() must be constant of ' . __CLASS__ );
    }
 
    /**
     * Create Product1
     * @return Product1
     */
    abstract public function createProduct1();
 
    /**
     * Product2
     * @return Product2
     */
    abstract public function createProduct2();
}

次にProduct11クラス。
Productは2つ扱うことにしてみます。
abstractfactory/product/Product1.php

 
<?php
namespace abstractfactory\product;
 
/**
 * Abstract Product1
 * @author $Author$
 */
abstract class Product1 {
    /**
     * Output class name of this Product
     */
    abstract public function showName();
}

Product2クラス。
abstractfactory/product/Product2.php

 
<?php
namespace abstractfactory\product;
 
/**
 * Abstract Product2
 * @author $Author$
 */
abstract class Product2 {
    /**
     * Output class name of this Product
     */
    abstract public function showName();
}

そしてFactoryを使用するClientクラス。
abstractfactory/Client.php

 
<?php
namespace abstractfactory;
 
/**
 * Factory Client
 * @author $Author$
 */
class Client {
    /**
     * Handle Products of specified type Factory
     * @param integer $type
     */
    public function handleProduct($type) {
        try {
            $factory = factory\Factory::getFactory($type);
            $factory->createProduct1()->showName();
            $factory->createProduct2()->showName();
        } catch (\Exception $e) {
            throw $e;
        }
    }
}
 

じゃあ実装クラスです。 Factoryクラスの実装その1である、ConcreteFactory1クラス。
abstractfactory/factory/ConcreteFactory1.php

 
<?php
namespace abstractfactory\factory;
 
/**
 * ConcreteFactory1
 * @author $Author$
 */
class ConcreteFactory1 extends Factory {
 
    /**
     * Create ConcreteProduct1_1
     * @return ConcreteProduct1_1
     */
    public function createProduct1() {
        return new \abstractfactory\product\ConcreteProduct1_1();
    }
 
    /**
     * Create ConcreteProduct1_2
     * @return ConcreteProduct1_2
     */
    public function createProduct2() {
        return new \abstractfactory\product\ConcreteProduct1_2();
    }
}

Factoryクラスの実装その2である、ConcreteFactory2クラス。
abstractfactory/factory/ConcreteFactory2.php

 
<?php
namespace abstractfactory\factory;
 
/**
 * ConcreteFactory2
 * @author $Author$
 */
class ConcreteFactory2 extends Factory {
 
    /**
     * Create ConcreteProduct2_1
     * @return ConcreteProduct2_1
     */
    public function createProduct1() {
        return new \abstractfactory\product\ConcreteProduct2_1();
    }
 
    /**
     * Create ConcreteProduct2_2
     * @return ConcreteProduct2_2
     */
    public function createProduct2() {
        return new \abstractfactory\product\ConcreteProduct2_2();
    }
}

ConcreteFactory1クラスが生成するProduct1の実装クラスであるConcreteProduct1_1クラス。
abstractfactory/product/ConcreteProduct1_1.php

 
<?php
namespace abstractfactory\product;
 
/**
 * Concrete Product1_1
 * @author $Author$
 */
class ConcreteProduct1_1 extends Product1 {
    /**
     * Return class name of this Product
     * @return string
     */
    public function showName() {
        print __CLASS__ . PHP_EOL;
    }
}

ConcreteFactory1クラスが生成するProduct2の実装クラスであるConcreteProduct1_2クラス。
abstractfactory/product/ConcreteProduct1_2.php

 
<?php
namespace abstractfactory\product;
 
/**
 * Concrete Product1_2
 * @author $Author$
 */
class ConcreteProduct1_2 extends Product2 {
    /**
     * Return class name of this Product
     * @return string
     */
    public function showName() {
        print __CLASS__ . PHP_EOL;
    }
}

ConcreteFactory2クラスが生成するProduct1の実装クラスであるConcreteProduct2_1クラス。
abstractfactory/product/ConcreteProduct2_1.php

 
<?php
namespace abstractfactory\product;
 
/**
 * Concrete Product2_1
 * @author $Author$
 */
class ConcreteProduct2_1 extends Product1 {
    /**
     * Return class name of this Product
     * @return string
     */
    public function showName() {
        print __CLASS__ . PHP_EOL;
    }
}

ConcreteFactory2クラスが生成するProduct2の実装クラスであるConcreteProduct2_2クラス。
abstractfactory/product/ConcreteProduct2_2.php

 
<?php
namespace abstractfactory\product;
 
/**
 * Concrete Product2_2
 * @author $Author$
 */
class ConcreteProduct2_2 extends Product2 {
    /**
     * Return class name of this Product
     * @return string
     */
    public function showName() {
        print __CLASS__ . PHP_EOL;
    }
}

以上でクラスは出そろったので、実行ファイル
abstractfactory/abstractfactory.php

 
<?php
namespace abstractfactory;
 
define('DIR', dirname(__FILE__));
 
require_once(DIR . DIRECTORY_SEPARATOR . 'Client.php');
 
require_once(DIR . DIRECTORY_SEPARATOR . 'factory' . DIRECTORY_SEPARATOR . 'Factory.php');
require_once(DIR . DIRECTORY_SEPARATOR . 'factory' . DIRECTORY_SEPARATOR . 'ConcreteFactory1.php');
require_once(DIR . DIRECTORY_SEPARATOR . 'factory' . DIRECTORY_SEPARATOR . 'ConcreteFactory2.php');
 
require_once(DIR . DIRECTORY_SEPARATOR . 'product' . DIRECTORY_SEPARATOR . 'Product1.php');
require_once(DIR . DIRECTORY_SEPARATOR . 'product' . DIRECTORY_SEPARATOR . 'Product2.php');
require_once(DIR . DIRECTORY_SEPARATOR . 'product' . DIRECTORY_SEPARATOR . 'ConcreteProduct1_1.php');
require_once(DIR . DIRECTORY_SEPARATOR . 'product' . DIRECTORY_SEPARATOR . 'ConcreteProduct1_2.php');
require_once(DIR . DIRECTORY_SEPARATOR . 'product' . DIRECTORY_SEPARATOR . 'ConcreteProduct2_1.php');
require_once(DIR . DIRECTORY_SEPARATOR . 'product' . DIRECTORY_SEPARATOR . 'ConcreteProduct2_2.php');
 
$client = new Client();
try {
    $client->handleProduct(factory\Factory::TYPE_1);
} catch (\Exception $e) {
    print $e->getMessage() . PHP_EOL;
}
 
try {
    $client->handleProduct(factory\Factory::TYPE_2);
} catch (\Exception $e) {
    print $e->getMessage() . PHP_EOL;
}
 
try {
    $client->handleProduct(999);
} catch (\Exception $e) {
    print $e->getMessage() . PHP_EOL;
}

で、実行ファイルを実行すると以下の様な出力が得られます。

abstractfactory\product\ConcreteProduct1_1
abstractfactory\product\ConcreteProduct1_2
abstractfactory\product\ConcreteProduct2_1
abstractfactory\product\ConcreteProduct2_2
Argument of abstractfactory\factory\Factory::abstractfactory\factory\Factory::getFactory() must be constant of abstractfactory\factory\Factory

残念ながらPHP5.3らしいことって何もできなかったですね＾＾； 名前空間を入れてみた、とか機能とはあんまり関係ないことだけです。 Abstract FactoryパターンだとClientがFactoryとProductの実装を知る必要がないので、
FactoryやProductのサブクラスが増えた場合には、FactoryとProductのサブクラスを実装して
Clientを使うクラスで使用するFactoryの識別(Factory::TYPE_n)を切り替える処理を実装すれば 他のクラスは便利に再利用できそうです。

大切なのはClientクラスは抽象クラスであるFactoryとProductしか扱わないこと。
ここに実装クラスが入ってくると、このパターンの意味がなくなってしまいます。
そして注意が必要なのは、Factoryの識別(Factory::TYPE_n)を誰が判断するか、ですね。

とあるクラスに一意に定義された値で処理を行いたい時にどうしてますか?
オブジェクト定数を使ってもいいのですが、そうするとタイプヒンティングが使えないので、
予定していない値が渡された時の処理を考える必要があります。

 
<?php
/**
 * Type
 */
class Type {
    /**
     * Type A
     * @var integer
     */
    const A = 0;
 
    /**
     * Type B
     * @var integer
     */
    const B = 1;
 
    /**
     * Type C
     * @var integer
     */
    const C = 2;
}
 
/**
 * Chech Type
 * @param integer $type Type to check
 */
function checkType($type) {
    if($type == Type::A) {
        print "Type is Type A\n";
    } else if($type == Type::B) {
        print "Type is Type B\n";
    } else if($type == Type::C) {
        print "Type is Type C\n";
    }
}
 
$a = Type::A;
$b = Type::B;
$c = Type::C;
 
checkType($a);//Type is A
checkType($b);//Type is B
checkType($c);//Type is C
 
checkType(5);//Not expected
checkType(null);//Type is A, but not expected
checkType(new stdClass());//Error, but not expected
 

予定しない値が渡った時の処理を考えるのも、ですが、
せっかくタイプヒンティングがあるので、
タイプヒンティングをうまく使う方法を考えます。

 
<?php
/**
 * Type
 */
class Type {
    /**
     * Instances of this class
     * @var array
     */
    private static $instances = array();
 
    /**
     * Return Type A
     * @return Type
     */
    public static function A() {
        if(!isset(self::$instances[__METHOD__])) {
            self::$instances[__METHOD__] = new Type(0);
        }
        return self::$instances[__METHOD__];
    }
 
    /**
     * Return Type B
     * @return Type
     */
    public static function B() {
        if(!isset(self::$instances[__METHOD__])) {
            self::$instances[__METHOD__] = new Type(1);
        }
        return self::$instances[__METHOD__];
    }
 
    /**
     * Return Type C
     * @return Type
     */
    public static function C() {
        if(!isset(self::$instances[__METHOD__])) {
            self::$instances[__METHOD__] = new Type(2);
        }
        return self::$instances[__METHOD__];
    }
 
    /**
     * Ordinal of this Class
     * @var integer
     */
    private $ordinal;
 
    /**
     * Private constructor
     * @param integer $ordinal Ordinal of this Class
     */
    private function __construct($ordinal) {
        $this->ordianl = $ordinal;
    }
 
    /**
     * Revoke clone
     */
    public function __clone() {
        throw new BadFunctionCallException('Clone is not allowed.');
    }
}
 
/**
 * Chech Type
 * @param Type $type Type to check
 */
function checkType(Type $type) {
    if($type == Type::A()) {
        print "Type is Type A\n";
    } else if($type == Type::B()) {
        print "Type is Type B\n";
    } else if($type == Type::C()) {
        print "Type is Type C\n";
    }
}
 
$a = Type::A();
$b = Type::B();
$c = Type::C();
 
checkType($a);//Type is A
checkType($b);//Type is B
checkType($c);//Type is C
 
checkType(null);//Error
checkType(new stdClass());//Error
checkType(new Type(1));//Error
$a2 = clone $a;//BadFunctionCallException
 

スタティックメソッドでインスタンスにアクセスするようにしました。
privateなconstructorと__cloneメソッドを実装して、
外部からのインスタンス作成と複製を無効にすれば
インスタンスが一意であることが保障されます。
タイプヒンティングを使っているので、
checkType()の内部では$typeはTypeのインスタンスであることが保障されます。

タイプヒンティングは便利なのですが、
足りてないところもあって、やきもきさせてくれます。
例えばスカラー型やオブジェクト型のタイプヒンティングが使えれば、
もっと便利に使えますよね。
PHPにはstdClassというクラスがあるのですが、stdClassはJavaのObject型とは違って、
全てのクラスのスーパークラスではありません。

 
function foo(/** not allowed */integer $i, /** not allowed */object $o) {}
 

ということで、今delfinoが使っているExtendedViewHelperです。
ViewHelperを実装する場合には、このExtendedViewHelperを拡張して実装しています。
ちなみに、こういうお約束の内容はFlex Builder(というかeclipse)のスニペットに登録しておくと便利です。
以下、ExtendedViewHelperのソースです。

 
package ${PackageName} {
	import com.adobe.cairngorm.control.CairngormEvent;
	import com.adobe.cairngorm.control.CairngormEventDispatcher;
	import com.adobe.cairngorm.view.ViewHelper;
 
	import flash.events.Event;
 
	import mx.events.FlexEvent;
	import mx.events.ValidationResultEvent;
	import mx.validators.Validator;
 
	/**
	 * ExtendedViewHelper
	 * @author $Author$
	 * 
	 */
	public class ExtendedViewHelper extends ViewHelper {
 
		/**
		/**
		* CairngormEventDispatcher
		*/
		protected static var dispatcher:CairngormEventDispatcher = CairngormEventDispatcher.getInstance();
 
		/**
		 * ViewLocator
		 */
		protected static var locator:ViewLocator = ViewLocator.getInstance();
 
		/**
		 * Validators of ExtendedViewHelper
		 */
		protected var validators:Array = new Array();
 
		/**
		 * initialization
		 * @param document view of ViewHelper
		 * @param id id of ViewHelper
		 * 
		 */
		override public function initialized(document:Object, id:String):void {
			super.initialized(document, id);
			this.view.addEventListener(FlexEvent.CREATION_COMPLETE, this.initViewHelper);
		}
 
		/**
		 * Initialize method of ExtendedViewHelper.<br />
		 * Override this method at sub classes.
		 * @param event Evet
		 * 
		 */
		protected function initViewHelper(event:Event):void {}
 
		/**
		 * Dispatch specified CairngormEvent.
		 * @param cairngormEvent
		 * 
		 */
		protected function dispatch(cairngormEvent:CairngormEvent):void {
			dispatcher.dispatchEvent(cairngormEvent);
		}
 
		/**
		 * Validate all Validators
		 * @return validate result
		 * 
		 */
		protected function validate():Boolean {
			if(Validator.validateAll(validators).length < 1) {
				return true;
			} else {
				return false;
			}
		}
 
		/**
		 * Clear all Validation result
		 * 
		 */
		protected function clearValidators():void {
			for each(var validator :Validator in this.validators) {
				validator.dispatchEvent(new ValidationResultEvent(ValidationResultEvent.VALID));
			}
		}
 
	}
}
 

少し説明をすると、ViewHelperのinitializedメソッドをオーバライドして、
ViewのCREATION_COMPLETE時にinitViewHelperがコールバックとして呼ばれるように設定しているのと、
ExtendedViewHelperのdispatcherフィールドにCairngormEventDispatcherを設定しています。

initViewHelperはViewのCREATION_COMPLETE時に呼ばれますから、
ここで例えばViewにEventListenerを設定したり、Validatorを設定したりします。
Viewに設定するValidatorは、ExtendedViewHelperのvalidatorsに追加しておくと
validateメソッドやclearValidatorsメソッドの対象にすることができます。

dispatchメソッドは、CairngormEventを発行する際に

 
CairngormEventDispatcher.getInstance().dispatchEvent(cairngormEvent);
 

と、いちいち書くのもおっくうなので、

 
this.dispatch(cairngormEvent);
 

と手抜きをする為のメソッドです。
毎回インスタンスの取得を行わないだけ、少しクライアントにも優しい部分もあるかもしれません。

validateメソッドは、フィールドvalidatorsに格納されているValidatorの検証を実行します。
ありがちな処理で、OKボタン押下時のコールバックなんかに使います。

 
private function onOKClick(event:Event):void {
	if(this.validate()) {
		//検証がOKなら処理の実行
	}
}
 

とか、こんな感じですね。

そして、clearValidatorsメソッドは、
フィールドvalidatorsに格納されているValidatorの検証結果をクリアします。
例えば、何かのVOの編集をする為のViewなんかで、
検証結果が残ったままなのもあれなので、こんな感じに使います。

 
public function set vo(value:VO):void {
	this._vo = value;
	this.clearValidators();
}
 

と、いうことでまずはViewHelperの拡張クラスについて、でした。
次はこの拡張ViewHelperを使ったViewHelperの実装についての予定です。
その後はCairngormEvent、そしてCommandについて、まとめてまいります。
そして、PureMVCについても、Cairngormシリーズの後にまとめます。

今回のメモはFlex側のアプリケーションの問題なので、
サーバサイドのアーキテクチャは関係ありません。
(サーバサイドがamfphpでもPyAMFでもBlazeDSでもLSDSでも)

例えばFlex側でこんなクラスhoge.Hoge.asを書いたとします。

 
package hoge {
	[RemoteClass(alias = "hoge.Hoge")]
	public class Hoge {
		public var name:String;
		public var value:String;
	}
}
 

 
<?xml version="1.0" encoding="utf-8"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute">
<mx:Script>
	<![CDATA[
		import mx.rpc.events.ResultEvent;
		private function getResult(event:ResultEvent):void {
			dgHoge.dataProvider = event.result;
		}
	]]>
</mx:Script>
	<mx:RemoteObject id="remoteObject" destination="default" source="HogeService" result="{getResult(event)}"/>
	<mx:VBox x="0" y="0">
		<mx:DataGrid id="dgHoge">
			<mx:columns>
				<mx:DataGridColumn headerText="Name" dataField="name"/>
				<mx:DataGridColumn headerText="Value" dataField="value"/>
			</mx:columns>
		</mx:DataGrid>
		<mx:Button id="btnGetHoge" label="getHoge" click="{remoteObject.getHoge()}"/>
	</mx:VBox>
 
</mx:Application>
 

さて、btnGetHogeがクリックされて、HogeServiceのgetHogeが実行された後
getResultメソッドの引数eventのresultに格納されているのは、何のクラスのオブジェクト配列でしょう。
hoge.Hogeクラスが定義されていてマッピングも定義されているのでhoge.Hogeクラスのオブジェクト配列になりそうなものですけど
実際にはObjectクラスのオブジェクト配列になります。
どうしてこういうことになるのかというと、
Flexのソースツリーの中にhoge.Hoge.asが含まれていたとしても
アプリケーション(この場合はhogeAppli.mxml)からhoge.Hogeクラスが参照されない限りは
hoge.Hoge.asはクラスマッピングの対象にならないようです。
FlexBuilderでは、hoge.Hoge.asにシンタックスの間違いがあってコンパイルが通らないようなソースであっても
ビルドが通ってしまいますから、そもそもコンパイルの対象にならないのかもしれませんね。

Site AccessをHostモードにした場合

なんですが、[SiteAccessSettings]セクションのHostMatchMapItems[]ディレクティブが
インストールウィザードで指定したものが反映されてないみたいです。
ezflow_site_userとezflow_site_adminがデフォルトの
ezflow_site_user.ドメイン名とezflow_site_admin.ドメイン名になっています。
修正してあげないとサイトにアクセスできないので、
インストールウィザードが終了した後に
ez Publish install directory/settings/override/site.ini.append.phpを修正いたしましょう。
後はez Publish install directory/settings/siteaccess以下にあるディレクトリ内のsite.ini.append.phpにある
[SiteSettings]セクションのAdditionalLoginFormActionURLも直したほうがよさげ。

Site AccessをデフォルトのURIにした場合には
URLがez Publish Site/index.php?Hogeとかそんな感じで生成されます。
これをez Publish Site/Hogeにしたい場合にはSite AccessをHostにする必要があります。
この場合はVirtualHostを使うことになるのですが、共有サーバとかでVirtualHostを使えないけど
サブドメインを使えるような場合(どのケースかとかはぐたぐた長くなるので割愛)には
site.iniの[SiteAccessSettings]セクションにForceVirtualHost=trueと指定してあげるとどうにかなるかもしれません。

なんかFLVが再生されないような

Delfinoの環境では再生されませんでした。
原因その1はflashvarsでmoviepathという変数を渡しているのですが
これが2回出力されている

moviepath=moviepath=Hoge

のも原因かもしれないのでとりあえずテンプレートを修正。
あ、これez Flowを使ってる場合の話です。
他は試してないので分りません。
ez Publish install directory/extension/ezflow/design/ezflow/override/templates/block/video.tplを修正します。
47行目で

        <param name="flashvars" value="moviepath={$flash_var}" />

としているので

         <param name="flashvars" value="{$flash_var}" />

に修正。
これでmoviepathが2重に送信されることはなくなったわけですが･･･はい、やっぱり流れませんね。
ものがSWFなので手を出せません。
ez Publishはオープンソースなので、もしかしたらソースが手に入るのかもですけど
ちょっとそこまで試す気になれないのでここまで。
久しぶりの更新も覚書。

てっとり早く結論

結論から書くと、AMFのエンコードとデコードを行う
AMFEXTというextensionがありますから、
そのextensionをPHPにインストールしておくと
amfphp1.9がextensionを認識して、高速に動作するようになる、ということです。
Patrickさんによると
We've tested it through and through, it is very stable, and let me tell you, it is ridiculously fast.
テストにテストを重ねてみたけど、とても安定していて、言わせてもらうなら、これめっちゃ早いで。
とのことです。(いつもながらに適当訳)

で、どうするか

AMFEXTのサイトからソースやバイナリがダウンロードできます。
Windowsユーザなら、バイナリのzipをダウンロードすると、
bin/windows以下にPHPのバージョンごとのdllがありますから、
使っているPHPのバージョンに該当するdllをPHPのextensionディレクトリに放り込んで
php.iniにphp_extension=php_amf.dllと追記して、Webサーバを再起動すればよしです。
Linuxユーザの場合は、phpizeを使ってPECL拡張モジュールとしてコンパイルできるそうです。
これは試してないので、説明ができません＾＾；
Linuxの場合は、php.iniにextension=amf.soを追記です。

extensionのセットアップが完了したらphpinfo()を実行するとamfの項目がでてきます。
で、amfphpのgateway.phpに直接ブラウザからアクセスしてみると、
「AMF C Extension is loaded and enabled.」の一文が増えてます。
後はextensionの力で高速になったamfphpが使える、ということですね。

ところが色々ありまして

AMFEXTを有効にした状態で、S2Baseのamfphpプラグインを使ってみたんですけど
どうもS2Dao_ArrayListのマッピングが変わってるみたいで、
AMFEXTを有効にしていない時のソースコードそのままでは動いてくれませんでした＾＾；
原因を調べてみないと、と思ってそのままになっていたので
AMFEXTの話を書いてなかったんです。＾＾；；

で、思い立ってちらっとソースを見ていると･･･AMFEXTってPHPライセンスじゃありませんか。
と、いうことは、AMFEXTを使った成果物はASL2.0に移行できる･･･のかな？
考えてみればエンコーダとデコーダがあるってことは、
amfphpでいうところのGatewayを作れば、S2AMF.PHP5･･･ですか？
ようやくコミッタらしい何かができますか？
そしてまたなれない翻訳大会の開始ですか？

amfphp1.9にはgzipサポートの機能があったり
Amfphp 1.9 beta 2 - ridiculously fasterには、
amfphp1.9の新機能の紹介が色々と書かれています。
amfphp1.9は、まだ公式サイトのドキュメントに落ちてない状態ですから
Patricさんのこのエントリを参考に色々と試してみるのもよいかと思われます。
amfphp2.0はどうなるかな。
SourceForgeの方では、ちょっと動きがないようですが。

追記

AMFEXTのサイトに書いてあるのですが、
AMFEXTってPECLでも公開されています。
PECLのはVersionが0.9.1になってますから、
AMFEXTのサイトにある0.9より新しいということになると思うのですが、
なんかヘッダファイルの更新日時が微妙ですね･･･＾＾；
そして、amfphpのSorceForgeのCVSにはAMFEXTが置かれてますね･･･。
こっちの方は最終更新が3/22ですから、うーん＾＾；；
AMFEXTのサイトには、SorceForgeに移行するよって書いてあるんですけど
一体どこに･･･あるんだろう･･･。
PECLのが最新版と思えばいいのかな･･･＾＾；；；

Cairngormでは、ViewLocatorを使ってViewとロジックを分離します。
アプリケーションの見た目に関る部分はMXMLに記述して、動作に関る部分はViewHelperに記述することで
見た目と動作を別のものにするわけですね。
具体的にはMXMLの中でそのViewに該当するViewLocatorを宣言しておきます。
Hogeというコンポーネントに対するViewHelperがHogeViewHelperならこんな感じです。

 
<?xml version="1.0" encoding="utf-8"?>
<mx:Panel 
	xmlns:mx="http://www.adobe.com/2006/mxml" 
	xmlns:viewhelper="hoge.viewhelper.*" >
	<viewhelper:HogeViewHelper id="hogeViewHelper" />
 

そうするとHogeViewのインスタンスが生成された時に
HogeViewHelperのインスタンスが生成されて、
HogeViewHelperのviewフィールドにHogeViewのインスタンスへの参照が設定されます。
で、あわせてViewLocatorにMXMLで指定したHogeViewHelperのidをキーとして
(Cairngormのドキュメントで言うところのcanonical name)
HogeViewHelperのインスタンスが登録されます。
後はViewLocatorのインスタンスにgetViewHelper("hogeViewHelper")とすると
HogeViewHelperのインスタンスを返してくれます。

もう少しつっこんで書くと、
HogeViewHelperのスーパクラスであるViewHelperクラスには
initializedメソッドが定義されていて、
このメソッドの中で自身のviewとidを設定して、
対象となるViewに対してイベントリスナを設定しています。
イベントリスナはEvent.ADDEDとEvent.REMOVEDで
対象となるViewが表示対象となった時には
ViewLocatorに対して自身を登録して、
対象となるViewが表示対象外となった時には
ViewLocatorに対して自身をします。

つまり、ViewHelperの準備が完了するには以下のステップがあります。

1. ViewHelperが設定されたViewのインスタンスが生成される。
2. ViewHelperのインスタンスが生成される。
3. ViewHelperがimplementsしているIMXMLObjectのinitializedメソッドが呼ばれる。
4. initializedメソッドの中でViewHelperのidフィールドとviewフィールドが設定される。
5. initializedメソッドの中でViewに対してイベントリスナが登録される。
6. Viewが表示対象となる。(ApplicationでaddChildされるとか)
7. イベントリスナに登録されたコールバックメソッドの中でViewHelperがViewLocatorに登録される。

これでようやくViewLocatorからViewHelperが取得できるようになるわけです。
反対にViewが表示対象外(ApplicationでremoveChildされるとか)すると
イベントリスナに登録されたコールバックメソッドの中でViewLocatorからViewHelperが削除されます。

はい、長々書きましたけど次に進みます。
FlexでPopUpを実現するには、PopUpManagerというクラスの3つのスタティックメソッドを使います。
シグネチャはこんな感じになってます。

 
public static function addPopUp(window:IFlexDisplayObject, parent:DisplayObject, modal:Boolean = false, childList:String = null):void
public static function createPopUp(parent:DisplayObject, className:Class, modal:Boolean = false, childList:String = null):IFlexDisplayObject
public static function removePopUp(popUp:IFlexDisplayObject):void
 

addPopUpかcreatePopUpでPopUpを表示して、removePopUpでPopUpを削除します。
addPopUpとcreatePopUpの違いは、
PopUpの対象をインスタンスで指定するか(addPopUp)
クラス名で指定するか(createPopUp)の違いです。

何も考えずApplicationの中でPopUpするなら、こんなコードを書くわけです。

 
var hogeView:HogeView = new HogeView();
PopUpManager.addPopUp(hogeView, this, true);
 

さて、ViewHelperを使うならどうしましょう。
しれっと考えるとViewHelperの中にpopUpとかいうメソッドを作って
それを呼びたいところですが、Viewのインスタンスが存在していないと
ViewHelperのインスタンスも存在していません。
ViewHelperがViewLocatorに登録されるのは
Viewが表示対象になった後なので、こんなコードもアウトです。

 
var hogeView:HogeView = new HogeView();
var hogeViewHelper:HogeViewHelper = HogeViewHelper(ViewLocator.getInstance().getViewHelper("hogeViewHelper"));
hogeViewHelper.popUp();
 

Viewが表示対象になるまではViewLocatorからViewHelperを取得できないので
PopUpしてからじゃないとViewHelperを使うことができない。ということです。
付け加えておくと、PopUpするためにはPopUp対象となる親コンポーネントを指定する必要があるので
親コンポーネントのViewHelperにViewを返すメソッドを定義しておいて、
子コンポーネントのViewHelperから親コンポーネントのViewHelperを取得して
親コンポーネントのViewHelperから親コンポーネントを取得してっていう
何やらスパゲッティな予感漂う実装になっちゃいますね。

はい、ということでこんな感じの実装はどうでしょう。
まず親コンポーネントのViewHelperにこんなメソッドを用意しておきます。

 
		public function createPopUp(className:Class, modal:Boolean = false, childList:String = null):IFlexDisplayObject {
			var parent:DisplayObject = ;
			return PopUpManager.createPopUp(parent, className, modal);
		}
 

で、PopUpする子コンポーネントのViewHelperにはこんなメソッドを。

 
		public function close():void {
			var window:IFlexDisplayObject = IFlexDisplayObject(this.view);
			PopUpManager.removePopUp(window);
		}
 

closeメソッドはこんな感じ親コンポーネントに実装することもできるでしょうけど

 
		public function close():void {
			var hogeViewHelper:HogeViewHelper = HogeViewHelper(ViewLocator.getInstance().getViewHelper("hogeViewHelper"));
			var window:IFlexDisplayObject = IFlexDisplayObject(hogeViewHelper.getView());
			PopUpManager.removePopUp(window);
		}
 

これだとHogeViewHelper側にViewを返すメソッド(getView())が必要になるので
ちょっといやな予感がしますね。
ちなみに親コンポーネントのViewHelperのcreatePopUpは、
addPopUpメソッドでもいける･･･と思います･･･試してませんけど＾＾；
PopUpManagerのremovePopUpメソッドが実行された時には、
REMOVEDなEventがdiapatchされますので、
ViewLocatorからHogeViewHelperの登録は削除されます。
つまり、後処理もちゃんとしてくれてるってことですね。

で、思い立ってGoogle先生に質問してみたところ、やっぱり当たるのはFxUGです。
フォーラムのエディタの色の変更についてを見れば解決です。
Eclipceのpluginディレクトリにあるcom.adobe.flexbuilder.editors.commonにcommon.jarがあります。
このcommon.jarの中にその名もColors.xmlというファイルがあって、どうやらここで色が設定されているようです。
なので、Eclipseを終了してからcommon.jarを解凍して、Colors.xmlを編集してもう一回common.jarという名前で圧縮して
Eclipseを起動すれば、これで黒背景でも目も優しい(そもそも本末転倒)色設定になります。
common.jarを編集する前にはバックアップをとっておきましょう。
困った時はFxUGですね。

と、スタイルの設定の仕方を学習中のDelfinoでした。
Cairngorm的にいくなら、見た目に関るところはView、動作に関るところはViewHelper。
Wikiにもちょっと書いているのですが、ViewHelperをうまく実装すれば、View(MXML)に書くのは対応するViewHelperの定義だけで済みます。
そうするとViewの中からonclick="ほげらほげら"とかいう動作に関る部分が抜けますし、
CairngormのCommandが成功した場合に実行される際の実装(IResponderのresultメソッド)もViewLocatorからViewHelperをとればよいわけです。
例えばありがちなログインに成功したら、ログイン完了画面に移行するという処理処理なら、
Stateを変える為のメソッドをViewHelperに用意しておいて、Commandのクラスのresultメソッドから
ViewHelperのステートを変えるメソッドを呼んだりとかするわけですね。
さてさて、じゃあViewの部分の表示に関るところは、というと全然不勉強だったので
ただいまStyleコンポーネントとかCSSについて勉強中であります。
チャートコンポーネントを使おうと思ったら、このあたりは必須ですね。

用語の解説は専門のサイトにお任せすることにして、
AOPっていうのは、OOPでいうところのクラスに横断することを集約してしまおうという考え方だと思ってます。
例えば、デバッグの為にメソッドの引数と戻り値をログ出力することを考えるとします。
これをひとつひとつのクラスのメソッドに実装していったら大改修です。
そこで引数と戻り値をログ出力する機能をAOPでいうところのAdviceとして実装して
対象となるクラスの任意の場所(Jointpoint)の集合(Pointcut)を定義して
AdviceをPointcutに対して適応(Weave)するのです。

さて、さっそく実践。
S2Container.PHP5では、AdviceをInterceptorとして実装します。
で、Interceptorを適応するにはdiconのcomponent要素にaspect要素を定義するか
クラスにAnnotationを記述するか
S2ContainerApplicationContextの自動アスペクトを使います。
今回はS2ContainerApplicationContextの自動アスペクトを使います。

S2Container.PHP5には元々組み込まれているInterceptorがあるのですが
せっかくなので自作いたしましょう。
せっかくついでなので、前のエントリに書いたEntityのValidationを行うInterceptorを使います。
このIntercetptorは、Daoに対して適応してinsert、updateといった更新系のメソッドが実行される際に
引数として渡されたEntityに値が設定されているかどうかをチェックして、
値が入っていなければ、例外を発行します。
Entityに値が必要かどうかを定義するのにプロパティ名_REQUIREDという定数をEntityに定義することにします。

このなでるシリーズではS2BasePluginクラスがEntityです。
では早速S2BasePluginクラスのコード。

 
<?php
class S2BasePlugin {
    const TABLE = "s2base_plugin";
    public function __construct(){}
 
    protected $id;
    const id_COLUMN = "id";
    public function setId($val){$this->id = $val;}
    public function getId(){return $this->id;}
 
    protected $name;
    const name_COLUMN = "name";
    const name_REQUIRED = "true";
    public function setName($val){$this->name = $val;}
    public function getName(){return $this->name;}
 
 
    public function __toString() {
        $buf = array();
        $buf[] = 'id => ' . $this->getId();
        $buf[] = 'name => ' . $this->getName();
        return '{' . implode(', ',$buf) . '}';
    }
 
 
    /*
    private $prop;
    const prop_RELNO = 0;
    const prop_RELKEYS = 'this_fk:other_pk';
    public function setProp(OtherEntity $entity){ $this->prop = $entity; }
    public function getProp(){ return $this->prop; }
    */
}
 

 
[ Command list ]
0 : (exit)
1 : dao
2 : dicon
3 : entity
4 : goya
5 : interceptor
6 : module
7 : service
choice ? : 5
 
[ Module list ]
0 : (exit)
1 : sample_module
choice ? : 1
 
interceptor class name ? : EntityValueValidatorInterceptor
 
[ generate information ]
  module name            : sample_module
  interceptor class name : EntityValueValidatorInterceptor
 
confirm ? (y/n) : y
 

 
<?php
class EntityValueValidatorInterceptor
    extends S2Container_AbstractInterceptor {
 
    /**
     * @param S2Container_MethodInvocation $invocation
     *    - $invocation->getThis()      : return target object
     *    - $invocation->getMethod()    : return ReflectionMethod of target method
     *    - $invocation->getArguments() : return array of method arguments
     */
    public function invoke(S2Container_MethodInvocation $invocation) {
        return $invocation->proceed();
    }
}
 

 
<?php
class EntityValueValidatorInterceptor
    extends S2Container_AbstractInterceptor {
 
    /**
     * column annotation sufix
     *
     */
    const COLUMN_ANNOTATION_SURFIX = "_COLUMN";
 
    /**
     * value required surfix
     * @var string
     */
    const REQUIRED_ANNOTATION_SURFIX = "_REQUIRED";
 
    /**
     * Getter name prefix
     * @var string
     */
    const GETTER_PREFIX = "get";
 
    /**
     * @param S2Container_MethodInvocation $invocation
     *    - $invocation->getThis()      : return target object
     *    - $invocation->getMethod()    : return ReflectionMethod of target method
     *    - $invocation->getArguments() : return array of method arguments
     */
    public function invoke(S2Container_MethodInvocation $invocation) {
        $args = $invocation->getArguments();
        $className = null;
        $reflectionClass = null;
        $getterName = null;
        $getterMethod = null;
        $getterResult = null;
        foreach($args as $arg) {
            $className = get_class($arg);
            if ($className != false) {
                $reflectionClass  = new ReflectionClass($className);
                //is entity?
                if(strpos($reflectionClass->getFileName(), S2BASE_PHP5_ENTITY_DIR) !== false) {
                    //get props
                    foreach($reflectionClass->getProperties() as $prop) {
                        //is column of table?
                        if($reflectionClass->hasConstant($prop->getName() . self::COLUMN_ANNOTATION_SURFIX)) {
                            //getter exist?
                            $getterName = self::GETTER_PREFIX . $prop->getName();
                            if($reflectionClass->hasMethod($getterName)) {
                                $getterMethod = $reflectionClass->getMethod($getterName);
                                if($getterMethod->isPublic()) {
                                    //value required?
                                    if($reflectionClass->hasConstant($prop->getName() . self::REQUIRED_ANNOTATION_SURFIX)) {
                                        $getterResult = $getterMethod->invoke($arg);
                                        //value exist?
                                        if($getterResult !== 0 && $getterResult == null) {
                                             throw new Exception($prop->getName() . " is required.");
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
        return $invocation->proceed();
    }
}
 

EntityValueValidatorInterceptor::invoke()の中身は
まずメソッドの引数を取得($methodInvocation->getArguments();)
引数のクラス名を取得して($className = get_class($arg);)
引数がクラスかどうかを判断。(if ($className != false))
クラスであるならReflectionを取得して($reflectionClass = new ReflectionClass($className);)
Entityかどうかを判断。(if(strpos($reflectionClass->getFileName(), S2BASE_PHP5_ENTITY_DIR) !== false))
EntityであるならプロパティのReflextionを取得してプロパティごとにループ。
(foreach($reflectionClass->getProperties() as $prop) {)
プロパティがテーブルのカラムと関連付けられているかを判断して
(if($reflectionClass->hasConstant($prop->getName() . self::COLUMN_ANNOTATION_SURFIX)) {)
プロパティのGetterメソッド名を取得して($getterName = self::GETTER_PREFIX . $prop->getName();)
Getterメソッドがあるかどうか判断。(if($reflectionClass->hasMethod($getterName)) {)
Getterメソッドがpublicかどうかを判断して、(if($getterMethod->isPublic()) {)
値が必要かどうかを判断。(if($reflectionClass->hasConstant($prop->getName() . self::REQUIRED_ANNOTATION_SURFIX)) {)
値が必要なら、GetterメソッドのReflectionを実行。
($getterResult = $getterMethod->invoke($arg);)
値がなければ例外発行。
という流れです。

では早速このInterceptorをDaoに適応します。
sample_moduleモジュールの設定ファイルが
sampleプロジェクトのapp/modules/sample_module/sample_module.inc.phpにあります。
ここでS2ContainerApplicationContextの設定を行っていますので、
このファイルを変更します。
オリジナルはこんな感じです。

 
<?php
S2ContainerApplicationContext::init();
S2ContainerApplicationContext::import(dirname(__FILE__) . '/dao');
S2ContainerApplicationContext::import(dirname(__FILE__) . '/entity');
S2ContainerApplicationContext::import(dirname(__FILE__) . '/interceptor');
S2ContainerApplicationContext::import(dirname(__FILE__) . '/service');
S2ContainerApplicationContext::import(S2BASE_PHP5_ROOT . '/app/commons/dao');
S2ContainerApplicationContext::import(S2BASE_PHP5_ROOT . '/app/commons/dicon/dao.dicon');
S2ContainerApplicationContext::registerAspect('/Dao$/', 'dao.interceptor');
 
?>
 

 
<?php
S2ContainerApplicationContext::init();
S2ContainerApplicationContext::import(dirname(__FILE__) . '/dao');
S2ContainerApplicationContext::import(dirname(__FILE__) . '/entity');
S2ContainerApplicationContext::import(dirname(__FILE__) . '/interceptor');
S2ContainerApplicationContext::import(dirname(__FILE__) . '/service');
S2ContainerApplicationContext::import(S2BASE_PHP5_ROOT . '/app/commons/dao');
S2ContainerApplicationContext::import(S2BASE_PHP5_ROOT . '/app/commons/dicon/dao.dicon');
S2ContainerApplicationContext::registerAspect('/Dao$/', 'EntityValueValidatorInterceptor', 'insert,update');
S2ContainerApplicationContext::registerAspect('/Dao$/', 'dao.interceptor');
 
?>
 

さて、せっかくなのでUnitTestを実行して、Interceptorが動作しているかどうか確かめてみましょう。
sampleプロジェクトのtest/modules/sample_module/dao/S2BasePluginDaoTest.phpを編集します。

 
<?php
class S2BasePluginDaoTest extends PHPUnit_Framework_TestCase {
    private $module = 'sample_module';
    private $container;
    private $dao;
    private $pdo;
 
    public function __construct($name) {
        parent::__construct($name);
    }
 
    public function testInsert() {
        $plugin = new S2BasePlugin();
        try {
            $this->dao->insert($plugin);
            $this->fail("Invalid insert!");
        } catch (Exception $e) {
        }
 
        $plugin->setName("TestPlugin");
        try {
            $this->dao->insert($plugin);
        } catch (Exception $e) {
            $this->fail("Invalid insert!");
        }
    }
 
    public function testUpdate() {
        $plugin = new S2BasePlugin();
 
        $serviceResult = $this->dao->findAllList();
        $iterator = $serviceResult->iterator();
        $plugin = $iterator->current();
 
        $plugin->setName(null);
        try {
            $this->dao->update($plugin);
            $this->fail("Invalid update!");
        } catch (Exception $e) {
        }
 
        $plugin->setName("TestPlugin");
        try {
            $this->dao->update($plugin);
        } catch (Exception $e) {
            $this->fail("Invalid update!");
        }
    }
 
 
    public function setUp(){
        print __CLASS__ . '::' . $this->getName() . PHP_EOL;
        $moduleDir = S2BASE_PHP5_ROOT . "/app/modules/{$this->module}";
        require_once($moduleDir . "/{$this->module}.inc.php");
        $this->container = S2ContainerApplicationContext::create();
        $this->dao = $this->container->getComponent('S2BasePluginDao');
        $dataSource = $this->container->getComponent("dataSource");
        $this->pdo = $dataSource->getConnection();
        $this->pdo->beginTransaction();
    }
 
    public function tearDown() {
        print PHP_EOL;
        $this->pdo->rollBack();
        $this->pdo = null;
        $this->container = null;
        $this->dao = null;
    }
 
}
 
 

 
% s2base test Dao
 

 
PHPUnit 3.1.8 by Sebastian Bergmann.
 
S2BasePluginDaoTest::testInsert
.S2BasePluginDaoTest::testUpdate
.
 
Time: 0 seconds
 
 
OK (2 tests)
 

S2Baseの基本となるmodule、Entity、Dao、Service、Interceptorを一通りなでましたので、
これでひとまずS2Baseをなでるシリーズは完結です。
S2Base2.0系から導入されたS2ContainerApplicationContextがでいい仕事をしてます。
Interceptorの適応も含めたdiconレスなコンポーネント定義で定義ファイルから開放されます。
ということで次回以降のSeasar.PHPをなでるシリーズは
S2ContainerApplicationContextをなでてみようかな、とか思っています。

例えばnot nullなcolumnを持つtableのEntity(S2DaoでいうところのEntity)があったとして、
このEntityに対してユーザが任意にデータ入力をするとします。
すると当然not nullなプロパティに値が入ってないなんてことはよくあることで
こういうところはUIのvalidatorとかで制御する･･･んでしょうね、きっと一般的に。
(前に使ったJSF+Spring+Hibernateではそうでした。)
とすると、たくさんUIがあると当然漏れとか、あるいはtableの仕様変更があったりすると、さぁ大変ですよね。
validationをすり抜けてnullのままinsertやupdateがかかったとしても、
実行時例外がでて、それはそれで終了ではありますけど。

こういうvalidationってインテグレーション層で行ったほうがいいんじゃないかな、と思ったわけです。
ここはZipCodeじゃないと、とかメールアドレスじゃないととかいうのは上位でvalidationすればいいわけですし
そういうことなら手を煩わせるのは仕方ないと思います。
S2Baseを使えばDaoやEntityは自動生成されます。
ここでEntityに対して、このプロパティはnot nullですよAnnotationを自動的に付加してあげれば
(仮にプロパティ名_REQUIREDというオブジェクト定数を自動生成するとします。)
こんなInterceptorを使えば、例外を投げることができますよね。

 
<?php
/**
 * Validate required property of entity  
 *
 */
class EntityValueValidatorInterceptor extends S2Container_AbstractInterceptor {
 
    /**
     * column annotation sufix
     *
     */
    const COLUMN_ANNOTATION_SURFIX = "_COLUMN";
 
    /**
     * value required surfix
     * @var string
     */
    const REQUIRED_ANNOTATION_SURFIX = "_REQUIRED";
 
    /**
     * Getter name prefix
     * @var string
     */
    const GETTER_PREFIX = "get";
 
    /**
     * invoke Interceptor
     * @param S2Container_MethodInvocation $methodInvocation
     * @return mixed Method result
     */
 
    public function invoke(S2Container_MethodInvocation $methodInvocation) {
        $args = $methodInvocation->getArguments();
        $className = null;
        $reflectionClass = null;
        $getterName = null;
        $getterMethod = null;
        $getterResult = null;
        foreach($args as $arg) {
            $className = get_class($arg);
            if ($className != false) {
                $reflectionClass  = new ReflectionClass($className);
                //is entity?
                if(strpos($reflectionClass->getFileName(), S2BASE_PHP5_ENTITY_DIR) !== false) {
                    //get props
                    foreach($reflectionClass->getProperties() as $prop) {
                        //is column of table?
                        if($reflectionClass->hasConstant($prop->getName() . self::COLUMN_ANNOTATION_SURFIX)) {
                            //getter exist?
                            $getterName = self::GETTER_PREFIX . $prop->getName();
                            if($reflectionClass->hasMethod($getterName)) {
                                $getterMethod = $reflectionClass->getMethod($getterName);
                                if($getterMethod->isPublic()) {
                                    //value required?
                                    if($reflectionClass->hasConstant($prop->getName() . self::REQUIRED_ANNOTATION_SURFIX)) {
                                        $getterResult = $getterMethod->invoke($arg);
                                        //value exist?
                                        if($getterResult !== 0 && $getterResult == null) {
                                             throw new Exception($prop->getName() . "is required.");
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
 
        $ret = $methodInvocation->proceed();
        return $ret;
    }
}
 

 
S2ContainerApplicationContext::registerAspect('/Dao$/', 'EntityValueValidatorInterceptor', 'insert,update');
 

･･･というか実際のnot nullチェックとかってみなさんどうしてるんでしょ？＾＾；