こんな風だし、
右クリックで、“構成”を選択すると、
こんな警告出るし、
こんなウィンドウが表示されるだけで、なんなんだよ、これ。って感じで、放置していた CF Frameworks Explorer 。
でも、ここ の「08 CF Frameworks Explorer Introduction」を見て、一気に解決。
]]> 続く...
こんな風だし、
右クリックで、“構成”を選択すると、
こんな警告出るし、
こんなウィンドウが表示されるだけで、なんなんだよ、これ。って感じで、放置していた CF Frameworks Explorer 。
でも、ここ の「08 CF Frameworks Explorer Introduction」を見て、一気に解決。
]]> 続く...で、とりあえず、http://localhost/shopping/model/ItemArrayBean.cfc?method=getItemArray にアクセス。
コンポーネント [[リポジトリ]]\shopping\www\model\ItemArrayBean.cfc のメソッド 'getItemArray' はリモートでアクセスできません。
cffunction の access 属性が public なのだから当然。
]]> 続く...
ここでは、Model-Glue の各種設定項目を、ＤＩコンテナである ColdSprng で設定しているということになる。
設定できる項目は、以下の通り。
では、今回の本題。Scaffold という機能もなかなか便利。
サンプルアプリケーションでいうと、Transfer.xml に記述してあるオブジェクトを指定して Scaffold を設定すると、そのオブジェクトのデータ管理ができる機能が自動で生成される。
以下のように ModelGlue.xml に一行付け加えるだけで、その機能ができてしまうのである。
<event-handlers>
……
<scaffold object="master.Item" />
</event-handlers>
で、http://localhost/shopping/index.cfm?event=master.Item.list にアクセスすると、そのテーブル内のデータが表示できる。
また、関数へのマウスオーバーでポップアップするヘルプを公式ドキュメントから抜き出して日本語訳してみたが、間違いもあるだろう。
仕様として、同じ関数名があると後に定義されたヘルプが出てしまうようなので、同じ関数名は、属するオブジェクトを連ねて表示し、両対応の当たり障りのない（中途半端な）ヘルプ文章にした。
以下、ちょっと用語解説。
]]> 続く...基本的には、両者とも、ＭＶＣフレームワークなわけで、「とりあえず作ってみました」的なレベルでは、大して差はなかった。
Controller に当たる handler で、設定することなく（Model-Glue は、設定することなく、setter 関数を入れるだけ） AutoWire はしてくれなかったので、handler 上の init 関数などで以下のように、取得する必要がある。
<cffunction name="init" access="public" returntype="any" output="false">
<cfargument name="controller" type="any">
<cfset super.init(arguments.controller)>
<cfset variables.shopping = getPlugin("ioc").getIoCFactory().getBean("shopping") />
<cfset variables.itemArrayBean = getPlugin("ioc").getIoCFactory().getBean("itemArrayBean") />
<cfreturn this>
</cffunction>
こうしておけば、handler が初めてよびだされるときに、ColdSpring で設定された Bean を呼び出してくれるのであろう。
また、Model-Glue では、ＸＭＬファイルで処理のフローを設定していたものが、ColdBox では、上記の handler 内でほとんど行うようだ。
ApplicationRoot
┗handlers
┗gengeral.cfc
gengeral.cfc という handler があって、その中に書かれている関数がイベント名になる。
例えば、gengeral.cfc に、CartView という関数があるとすると、gengeral.CartView というイベントを駆動させると、その CartVew 関数が処理される。
あとは、TransferFactory など、AutoWire 関連の記述を書き換えるぐらいでモデルなどのコードは、ほとんど変更しなかった。この辺りは、さすがである。
当然、画面表示周りの部分は、それなりに書き換える必要がある。イベント名の作法が変わるわけだし、画面表示自体の作法が変わる。
個人的な問題として気になることがあった。
開発する際、ＷＥＢサーバー（Windows マシンで、IIS）のドキュメントルートにプログラムを置くのではなく、リポジトリとして決めてある場所にプログラムを保存して、実行は、IIS 上で仮想ディレクトリを設定してある。
プログラムを変更した場合、保存後、すぐに、ブラウザのＦ５リフレッシュで変更結果を確認している。
ColdBox でそのように作成しようとしたら、なぜか、エラーが発生してしまった。設定があるのかもしれないが、わからなかったので、結局、Ant を使って、ＷＥＢサーバーのドキュメントルートに配置していたわけで、結果、前回のようなエラーにも遭遇した。
ColdBox のイメージがちょっぴり悪くなってしまった。もちろん、ColdBox は悪くないのだろう。あくまで、個人的な問題だ。
やり方としては、コンポーネント内の指定した関数を丸ごとトランザクション処理するというイメージになる。
shopping.model.CartProcess の transfer.TransferFactory を AutoWire したタイミングで、transfer.TransferFactory から transfer.com.sql.transaction.Transaction を取得する。
<cffunction name="setOrmService" access="public" returntype="void" output="false">
<cfargument name="ormService" type="transfer.TransferFactory" required="true">
<cfset variables.transfer = arguments.ormService.getTransfer() />
<cfset variables.transaction = arguments.ormService.getTransaction() />
</cffunction>
その Transaction を利用して、
<cfset transaction.execute(component, methodName, [arguments]) />
と、直接的に関数をトランザクション指定で起動することもできる。
直接指定の場合は、その関数を利用するときに、上記の記述で利用することになる。
また、ＡＯＰのように記述して、関数を指定することで、指定した関数が丸ごとトランザクション処理されるようだ。
この記述の場合は、事前に行っておくことで、その関数を通常のように利用した場合でも、トランザクション処理されることになる。
<cffunction name="setOrmService" access="public" returntype="void" output="false">
<cfargument name="ormService" type="transfer.TransferFactory" required="true">
<cfset variables.transfer = arguments.ormService.getTransfer() />
<cfset variables.transaction = arguments.ormService.getTransaction() />
<cfset variables.transaction.advise(this, insertItem) />
</cffunction>
さらに、
<cfset arguments.transaction.advise(this, "^save") />
と、正規表現で一括してトランザクション処理指定もできる。
トランザクションで処理したい関数を save で始まる関数名にしておけば、簡単に一括指定できる。
例えば、だいぶ前に WebSphere で ＩＢＭ謹製 Studio を使ったときに、設定ファイルは、入力ボックスに各種設定の文字を入れていくようなウィンドウが表示されて、ＸＭＬタグを見ることなく設定できた。
ＸＭＬファイルというのは、慣れていればいいのかもしれないが、経験の少ない開発者にとって敷居が高いものだと勝手に断定している。
一番いいのは、部品をドラッグアンドドロップとかで配置して、グラフィカルにＭＶＣの流れが見えることだと思うけど、そんなのはかなり厳しい話で、WebSphere のようなものが妥当な線なんだと思う。
Model-Glue のイベント自動生成機能は、イベント名を起こすだけで、ある程度の設定をしてくれるということだから、ゼロから設定ファイルを書くのではなく、都度変更すればよいわけだ。
ゼロからと、変更するだけでは、大きな違いがあると思うし、かなり敷居が低くなるんじゃないかと思う。
今までのようにＸＭＬを直接編集するしかないとか、（あくまで個人的に）作業効率が悪いままでは、結局フレームワークというものが、万人向けではなく、特定層向けツールで終わってしまっているというのが現状ではないだろうか。
なにしろ、ColdFusion の最大の特徴である、「未経験開発者の一定レベル到達時間が短い」を打ち消しかねない。
ちょっと言い過ぎた気もするけど、一向に ColdFusion のフレームワークの情報が世の中に増えてこないのは、その辺にあるのじゃないだろうか。
Model-Glue の新機能に期待である。
The term "autowire" refers to the ability of the ColdSpring beanFactory to automatically wire dependent objects together without necessarily having to define those dependencies in the xml bean definitions.
前回、
<bean id="shopping" class="shopping.model.CartProcess">
<property name="itemAB">
<ref bean="itemArrayBean" />
</property>
</bean>
このような記述をした。
ColdSpring.xml の Bean は、基本的にリクエストごとに、初期化される。
shopping.model.CartProcess を初期化する際に、setItemAB 関数を探して、引数として、itemAB という名前で、itemArrayBean を
渡して処理しなさいということであった。
AutoWire を使えば、この記述が以下のように簡単になる。
<bean id="shopping" class="shopping.model.CartProcess" autowire="byName" />
autowire="byName" をautowire="byType" とすることもできる。
要するに、Bean を受け取りたい側（この場合は、CartProcess.cfc）で、setter 関数を記述さえすれば、取得できるわけである。
byName と、byType は、どう違うのか。名前と型なわけで、全く違うわけだが、byName であれは、setItemAB と名前で探すのに対し、
<bean id="shopping" class="shopping.model.CartProcess" autowire="byType" />
<cfargument name="itemArrayBean" type="shopping.model.ItemArrayBean" />
byType の場合は、setter 関数の名前は set で始まっていればよく、引数の受取の型指定が一致しているものを探すわけである。
同じ型で複数の Bean を作りたい場合には、byName にすることになるだろう。
byTypeの方は、すでに setter 関数があって、名前が重複してしまった場合などに利用することになるだろう。
基本的には、好みで決めればいいのだろう。byType の方が、好みだ。
<bean id="itemArrayBean" class="shopping.model.ItemArrayBean">
<property name="itemArray">
<list>
<map>
<entry key="name"><value>光学式マウス</value></entry>
<entry key="price"><value>2600</value></entry>
</map>
<map>
<entry key="name"><value>ボール式マウス</value></entry>
<entry key="price"><value>1100</value></entry>
</map>
<map>
<entry key="name"><value>レーザー式マウス</value></entry>
<entry key="price"><value>4800</value></entry>
</map>
</list>
</property>
</bean>
<?xml version="1.0" encoding="UTF-8"?>
shopping.model.ItemArrayBean は、商品リストデータを保持するコンポーネント。
Java でいうところの、Bean ということになる。ColdSpring でも、この Bean という単語を採用している。
デフォルトでは、リクエストごとに、インスタンスが生成されているようだ。
固定値を保持するような Bean は、アプリケーションで１インスタンスでいいのだから、何かしら、やり方があるのだろうか。
singleton とかの記述もマニュアルにあるし、できそうな雰囲気もあるが、試していない。
では、実際に、これを利用するためには、どうすればよいのか。
コントローラーでは、非常に簡単に利用できる。
getModelGlue().getBean("itemArrayBean") これだけで、取得できてしまうのである。
Controller.cfc にある、onRequestStart 関数に
<cfset variables.itemArrayBean = getModelGlue().getBean("itemArrayBean") /> とすれば、Controller.cfc 上では、いつでも、利用可能になる。
また、あたかも、AutoWire のように、
<cffunction name="setItemArrayBean" access="public" returnType="void" output="false">
<cfargument name="itemArrayBean" type="any">
<cfset variables.itemArrayBean = arguments.itemArrayBean />
</cffunction>
としてやるだけでも、取得できてしまう。
「あたかも、AutoWire のように」としたのは、ColdSpring.xml の bean タグに、AutoWire の設定することなく、
setter 関数が処理されたためにこのような表現をした。コントローラーは、本当に特別なもののようだ。
AutoWire については、また、後日、読み解いてみたい。