Eclipse 4 (e4) Tutorial Part 6: アノテーションの振る舞い

Eclipse 4 (e4) Tutorial Part 6: Behavior Annotations

http://eclipsesource.com/blogs/tutorials/eclipse-4-e4-tutorial-part-6-behavior-annotations/

----

この連載シリーズの以前のパートでは、アプリケーションモデルの作り、それを実装にリンクする方法、アプリケーションモデルを拡張する方法を説明しました。このチュートリアルの最後のパートでは、依存性注入の詳細を説明します。<br>
ある場所でどのパラメータが注入されるかについて影響を与える方法にフォーカスします。多くの場合では、正確にいつパラメータが注入されるか、さらに精密に、あるクラスのあるメソッドがフレームワークによっていつ呼び出されるかを仕様化することも重要になります。<br>
Eclipse 4は、この目的にアノテーションを使用します。このチュートリアルでは、Eclispe 4で使われる最も重要なアノテーションを説明します。</p>
<h2>注入タイミング?</h2>
<p>このチュートリアルの以前のパートで説明した、@Named and @Optionalと組み合わせた @Injectアノテーションを使うと、コンストラクタとフィールドへの依存性注入は、十分制御できます。どちらの場合でも、オブジェクトが注入される時点は明確(クラスがインスタンス化されるとき)です。メソッドが@Injectのみでマークアップされている時、これらのメソッドは、クラスが初期化された後に一度呼ばれ、以降、コンテキスト内でパラメータが変化する度に呼ばれます。<br>
しかし、開発者がある種のイベント、例えば、ビューがフォーカスを得た場合や、オブジェクトが削除されたときなどに反応したいと考えるような多数のユースケースがあります。<br>
Eclipse 3.xのインタフェースでは、これらのイベント向けのメソッドを定義していました。<br>
例えばsetFocus()は、あるイベントがトリガされたときにフレームワークによってよばれます。<br>
Eclipse 4では、ビューはPOJOであり、任意の名前を付けることが可能です。そのため、ある時点でフレームワークに呼ばれる必要があるメソッドは、例えば、@Focusなど、対応するアノテーションでマークアップしなければなりません。すべてのここで説明されるアノテーションは、@Injectと同様に依存性注入の振る舞いを含みます。<br>
つまり、もし、以下で説明するアノテーションでメソッドがマークアップされていれば、そのメソッドのすべてのパラメータは、@Injectを明示的に付けなくても注入が行われるでしょう。</p>
<h2>@PostConstruct と @PreDestroy</h2>
<p>多くのケースでは、オブジェクトは、コンストラクタが呼ばれた後に追加の初期化処理を必要とします。これは、フィールドを使用している場合に特にあてはまります。フィールドは、コンストラクタが呼ばれた後に注入されるので、フィールドに依存する初期化は、コンストラクタ内では行うことができません。</p>
<p>オブジェクトを初期化する典型的なタスクは、リスナの登録です。リスナは、オブジェクトがそれ以上必要なくなったときに登録解除される必要があります。<br>
このユースケースに対して、Eclipse 3.xのインタフェースは、たいていinit()やdispose()のようなメソッドを用意しています。<br>
Eclipse 4では、 javax.annotationで定義されている@PostConstruct と @PreDestroyなる２つの標準的なアノテーションを使います。</p>
<p>@PostConstructでアノテートされたメソッドは、クラスがそのコンストラクタで初期化された後、もしくはすべてのフィールドが注入された後に呼ばれます。<br>
@PreDestroyでアノテートされたメソッドは、オブジェクトが必要とされなくなった時、例えば、対応するビューがクローズされ、そのオブジェクトが削除される前に呼ばれます。
以前に触れたように、すべてのアノテーションは、これらのメソッドで追加のパラメータを使うことができ、義務的に並べる必要はありません。<br>
次のコードは典型的な使用例を示します。サービスは、フィールドとして注入され、それゆえ、コンストラクタで使用することはできません。@PostConstruct メソッドは、そのサービス上でリスナ登録するのに使われ、@PreDestroyメソッドは、リスナ登録を解除するのに使われます。</p>

<div class="wp_syntax"><table><tr><td class="code"><pre class="java" style="font-family:monospace">@Inject
MyService service<span style="color:#339933">;</span>
 
@PostConstruct
<span style="color:#000000;font-weight:bold">public</span> <span style="color:#000066;font-weight:bold">void</span> postConstruct<span style="color:#009900">(</span><span style="color:#009900">)</span> <span style="color:#009900">{</span>
   service.<span style="color:#006633">addListener</span><span style="color:#009900">(</span><span style="color:#000000;font-weight:bold">this</span><span style="color:#009900">)</span><span style="color:#339933">;</span>
<span style="color:#009900">}</span>
 
@PreDestroy
<span style="color:#000000;font-weight:bold">public</span> <span style="color:#000066;font-weight:bold">void</span> preDestroy<span style="color:#009900">(</span><span style="color:#009900">)</span> <span style="color:#009900">{</span>
   service.<span style="color:#006633">removeListener</span><span style="color:#009900">(</span><span style="color:#000000;font-weight:bold">this</span><span style="color:#009900">)</span><span style="color:#339933">;</span>
<span style="color:#009900">}</span></pre></td></tr></table></div>

<p>@PostConstruct と @PreDestroyはすべてのクラス向けに利用でき、フレームワークまたは注入ファクトリを手動で使うことによって初期化されます。</p>
<h2>@Focus</h2>
<p>パーツなどのビジュアル要素に対しては、実装が反応すべき追加的なイベントがあります。@Focusアノテーションでマークアップされたメソッドは、対応するUI要素がフォーカスを取得したときに呼ばれます。<br>
SWTアプリケーションでは、フォーカスは中心的なSWT要素、例えばテキストフィールドやツリーUIに送られるはずです。ビュー実装が複数のSWTコントロールを含んでいるとき、開発者はコントロールを選択する必要があります。フォームエディタであれば、たいていは最初のテキストフィールドになります。</p>

<div class="wp_syntax"><table><tr><td class="code"><pre class="java" style="font-family:monospace">@Focus
<span style="color:#000000;font-weight:bold">public</span> <span style="color:#000066;font-weight:bold">void</span> onFocus<span style="color:#009900">(</span><span style="color:#009900">)</span> <span style="color:#009900">{</span>
   text.<span style="color:#006633">setFocus</span><span style="color:#009900">(</span><span style="color:#009900">)</span><span style="color:#339933">;</span>
<span style="color:#009900">}</span></pre></td></tr></table></div>

<h2>@Persist</h2>
<p>@Persistアノテーションは、パーツ上で保存がトリガされたときに呼ばれるメソッドにマークアップします。<br>たとえば、そのパーツがテキストエディタに相当する場合、テキストコントロールの内容はファイルに保存されます。</p>

<div class="wp_syntax"><table><tr><td class="code"><pre class="java" style="font-family:monospace">@Persist
<span style="color:#000000;font-weight:bold">public</span> <span style="color:#000066;font-weight:bold">void</span> save<span style="color:#009900">(</span><span style="color:#009900">)</span><span style="color:#009900">{</span>
	<span style="color:#666666;font-style:italic">//save the context of the part</span>
<span style="color:#009900">}</span></pre></td></tr></table></div>

<p>このメソッドは、例えば、ハンドラなど、たいてい他の場所から呼ばれます。パーツサービスは、特定のパーツもしくはダーティ状態のすべてのパーツを保存するためのヘルパメソッドを提供します。</p>

<div class="wp_syntax"><table><tr><td class="code"><pre class="java" style="font-family:monospace">@Execute
<span style="color:#000000;font-weight:bold">public</span> <span style="color:#000066;font-weight:bold">void</span> execute<span style="color:#009900">(</span>@Named<span style="color:#009900">(</span>IServiceConstants.<span style="color:#006633">ACTIVE_PART</span>
 MPart part,EPartService partService<span style="color:#009900">)</span> <span style="color:#009900">{</span>
   partService.<span style="color:#006633">savePart</span><span style="color:#009900">(</span>part, <span style="color:#000066;font-weight:bold">false</span><span style="color:#009900">)</span><span style="color:#339933">;</span>
<span style="color:#009900">}</span></pre></td></tr></table></div>

<h2>@PersistState</h2>
<p>@PersistStateでマークアップされたメソッドは、オブジェクトが廃棄される前で、かつ、@PreDestroyでマークアップされたメソッド呼び出しの前に、呼ばれます。このメソッドの目的は、必要に応じて要素の最新の状態を保持することです。<br>
もしそのメソッドがビューであれば、最新のユーザ入力が利便性のために保存されるといったことが可能になるでしょう。</p>
<h2>@Execute と @CanExecute</h2>
<p>特にハンドラに向けた @Execute と @CanExecuteといった追加的な２つのアノテーションがあります。@Executeは、ハンドラ自身が実行される場合に実行されるメソッドをマークアップします。@CanExecuteは、ハンドラの実行可能状態を管理するメソッドをマークアップします。<br>
そのため、@CanExecuteが与えられたメソッドは、ブール値を返す必要があり、フレームワークに対して、実装されたアクションが現在使用できるか否かを知らせます。結果として、Eclipse 4は、すべてのメニューとツールバー項目をこのハンドラにリンクする形でイネーブル、ディスエーブルに設定します。すべてのアノテーションに関して、すべての要求されたパラメータは、注入されます。
</p>
<p>しかし、@CanExecuteアノテーションは、他のアノテーションとはとても異なる動作をします。
このアノテーションは、ある種のイベントやコンテキスト内の何らかのパラメータ変更に基づいて呼ばれません。実際に、バージョン4.2では、継続的にタイマーベースで呼ばれます。なので、このメソッド内で多くの時間を費やすことを避けることは重要です。</p>
<p>@CanExecute メソッドのありふれた実装例は、現在の選択、アクティブなパーツ、アクティブなパースペクティブに対するチェックです。<br>
次の例では、現在の選択対象が、特定の型を持ち、もしそうならハンドラを有効にするといったチェックを行います。@Executeメソッドは、現在の選択についてあるアクションを実行します。</p>

<div class="wp_syntax"><table><tr><td class="code"><pre class="java" style="font-family:monospace">@CanExecute
<span style="color:#000000;font-weight:bold">public</span> <span style="color:#000066;font-weight:bold">boolean</span> canExecute<span style="color:#009900">(</span>@Named<span style="color:#009900">(</span>IServiceConstants.<span style="color:#006633">ACTIVE_SELECTION</span><span style="color:#009900">)</span>
                      	@Optional <span style="color:#003399">Object</span> selection<span style="color:#009900">)</span> <span style="color:#009900">{</span>
   <span style="color:#000000;font-weight:bold">if</span> <span style="color:#009900">(</span>selection<span style="color:#339933">!=</span><span style="color:#000066;font-weight:bold">null</span> <span style="color:#339933">&amp;</span>amp<span style="color:#339933">;&amp;</span>amp<span style="color:#339933">;</span> selection <span style="color:#000000;font-weight:bold">instanceof</span> MyObject<span style="color:#009900">)</span>
  	<span style="color:#000000;font-weight:bold">return</span> <span style="color:#000066;font-weight:bold">true</span><span style="color:#339933">;</span>
   <span style="color:#000000;font-weight:bold">return</span> <span style="color:#000066;font-weight:bold">false</span><span style="color:#339933">;</span>
<span style="color:#009900">}</span></pre></td></tr></table></div>

<h2>ライフサイクルアノテーション</h2>
<p>最後の説明となりますが、Eclipse 4は、アプリケーションの実行ライフサイクルをフックする機能を提供します。これを行うためには、ライフサイクルハンドラが登録されたアプリケーションのプロパティとして登録される必要があります。<br>



<div class="wp_syntax"><table><tr><td class="code"><pre class="xml" style="font-family:monospace"><span style="color:#009900"><span style="color:#000000;font-weight:bold">&lt;property</span> <span style="color:#000066">name</span>=<span style="color:#ff0000">"lifeCycleURI"</span>               </span>
<span style="color:#009900"><span style="color:#000066">value</span>=<span style="color:#ff0000">"platform:/plugin/helloworld/helloworld.LifecycleHandler"</span><span style="color:#000000;font-weight:bold">&gt;</span></span></pre></td></tr></table></div>



</p>
<p>ライフサイクルハンドラ自身の実装は、POJOです。</p>
<p><b>@PostContextCreate</b></p>
<p>アプリケーションコンテキストが生成された後に呼ばれます。コンテキストにオブジェクトを追加したり、削除したりするのに使うことができます。</p>
<p><b>@ProcessAdditions と @ProcessRemovals</b></p>
<p>スクリーン上にアプリケーションを表示するためのレンダラに渡される前に、アプリケーションモデルの変更を可能にします。アプリケーションが実際に表示される前にアプリケーションモデルの要素を追加したり、削除することが可能になります。</p>
<p><b>@PreSave</b></p>
<p>アプリケーションモデルが保存される前に呼ばれます。保存前にモデルを変更することが可能になります。</p>
<h2>まとめ</h2>
<p>Eclipse 4の振る舞いについてのアノテーションは、オブジェクトの精密な注入時点を定めることができます。アノテートされたメソッドは、パラメータを要求することができます。
しかし、必要無ければそうする必要はありません。<br>
例えば、@Focusでアノテートされたメソッドは、しばしばパラメータを必要としません。このケースにおいては、フォーカスメソッドが、対応するUI要素がフォーカスを取得したタイミングで呼ばれることの方が重要となります。
@Inject, @Named, @PostConstruct, @PreDestroyのようなアノテーションはJava標準です。@Optional, @Persistのような追加的なアノテーションは、Eclipse 4特有のものです。</p>
<p>利用できるアノテーションのソースの概要を得るために、これまでに説明したすべてのアノテーション
と、それを定義しているバンドルを以下のリストを示します。もし、これらのアノテーションのいくつかを利用する場合、依存設定やパッケージのインポートが必要になります。</p>
<table width="623" border="1" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td valign="top" width="312">@Active</td>
<td valign="top" width="312">org.eclipse.e4.core.contexts</td>
</tr>
<tr>
<td valign="top" width="312">@Creatable</td>
<td valign="top" width="312">org.eclipse.e4.core.di.annotations</td>
</tr>
<tr>
<td valign="top" width="312">@CanExecute</td>
<td valign="top" width="312">org.eclipse.e4.core.di.annotations</td>
</tr>
<tr>
<td valign="top" width="312">@Execute</td>
<td valign="top" width="312">org.eclipse.e4.core.di.annotations</td>
</tr>
<tr>
<td valign="top" width="312">@Inject</td>
<td valign="top" width="312">javax.inject</td>
</tr>
<tr>
<td valign="top" width="312">@Named</td>
<td valign="top" width="312">javax.inject</td>
</tr>
<tr>
<td valign="top" width="312">@Optional</td>
<td valign="top" width="312">org.eclipse.e4.core.di.annotations</td>
</tr>
<tr>
<td valign="top" width="312">@Persist</td>
<td valign="top" width="312">org.eclipse.e4.ui.di</td>
</tr>
<tr>
<td valign="top" width="312">@PersistState</td>
<td valign="top" width="312">org.eclipse.e4.ui.di</td>
</tr>
<tr>
<td valign="top" width="312">@PostConstruct</td>
<td valign="top" width="312">javax.annotation</td>
</tr>
<tr>
<td valign="top" width="312">@ProcessAdditions</td>
<td valign="top" width="312">org.eclipse.e4.ui.workbench.lifecycle</td>
</tr>
<tr>
<td valign="top" width="312">@ProcessRemovals</td>
<td valign="top" width="312">org.eclipse.e4.ui.workbench.lifecycle</td>
</tr>
<tr>
<td valign="top" width="312">@PostContextCreate</td>
<td valign="top" width="312">org.eclipse.e4.ui.workbench.lifecycle</td>
</tr>
<tr>
<td valign="top" width="312">@PreDestroy</td>
<td valign="top" width="312">javax.annotation</td>
</tr>
<tr>
<td valign="top" width="312">@PreSave</td>
<td valign="top" width="312">org.eclipse.e4.ui.workbench.lifecycle</td>
</tr>
</tbody>
</table>
<p> </p>

----
完結！