まずは先般の西日本豪雨で被災されました皆様に、心よりお見舞い申し上げます。
神戸もかなりの雨量で、未だ市内でも道路が封鎖されている場所が残っております。
氾濫すらしませんでしたが、自宅前の川が1週間を経過したにもかかわらず、普段の3倍ほどの水量が続いており、油断できない状況です。
さてそんな中ではありますが、以前より少し気になっていたXPagesのソースについて、自分の学習用に調べてみたいことがありましたので、せっかくならと記事にさせて頂きます。
ぜひ今さらと言わず、お付き合い頂けましたら幸いです。
さて過去にいくつか記事にしましたが、XPagesはGUIにてコントロールを配置し、プロパティを設定して組み上げていくことで、できるだけ簡単にプログラミングされたWEBページを生成することが目的であるNotesの設計要素であることは周知かと思います。
[設計]タブから[ソース]タブに切り替えてみますと、空白のページであっても、以下のようなソースが記述されたXMLであることがわかります。
まずはデータソースをバインドした場合の変化を見てみます。
今回は同じアプリケーション内の"planning"というDomino文書をバインドしてみました。
このように<xp:this.data>のタグ内にデータソースの定義が組み込まれることを宣言し、<xp:dominoDocument>タグでDomino文書である"planning"フォームを呼び出しています。
参考までにビューをバインドした場合、
<xp:dominoView var="view1" viewName="test"></xp:dominoView>
となります。
なおこのとき、アウトラインには以下のように表示されます。
先の文書をバインドした状態で、[編集ボックス]を追加してみましょう。
すると以下の1行追加されたことがわかります。
<xp:inputText id="inputText1"></xp:inputText>
続いて、"date"というフィールドをバインドしてみます。
以下のようにinputTextにvalueが追加されることがわかります。
次にボタンを追加してみますと、以下の一行が追加されました。
<xp:button value="ラベル" id="button1"></xp:button>
それではそのボタンに「文書の保存」を設定してみます。
以下のように"onclick"のイベントが追加され、"action"として<xp:saveDocument>が追加されました。
ここまでで[設計]画面は以下のようになっています。
それではボタン部分のソース(以下の部分)をコピーして、ソースの続きに貼り付けてみます。
すると、以下のようにボタンが追加されることが確認できます。
なおソースを確認すると、以下のように自動で"id"がユニークな番号に変化していることがわかります。
このようにコントロールを複製するような場合、もちろん[設計]画面で対象コントロールをコピーすることも可能ですが、ソース側でも同じことが可能であることがわかるかと思います。
次にカスタムコントロールを見てみます。
まずは初期作成時のソースです。
このようにカスタムコントロールのソースもXPagesのソースとまったく同一になります。
それでは編集ボックスとボタンを追加したソースもみてみましょう。
今回、値のバインドやボタンアクションの設定は省きましたが、XPagesと同一のソースであることがわかるはずです。
つまりXPageで作成したものをカスタムコントロール作り変えたり、その逆についてもいちいちコントロールの配置から行う必要はなく、ソースをコピーして貼り付けることで、同一内容でありながら、別の設計要素を作成することが可能になります。
最後にカスタムコントロールをXPagesに埋め込んでみますと、
<xc:xctest></xc:xctest>
この一行のみでカスタムコントロール"test"を呼び出すことができます。
以上、表面的なことばかりではありますが、ソースを知ることで、作業の簡素化ができる場合があるということはご理解いただけましたでしょうか。
XPages開発者はGUIを使用せず、ソースだけを直接編集して、ページを実現されている方もいらっしゃると聞きます。
個々のコントロールの記述や、値設定などを確認されても面白いかと思います。
