配備記述子に代わる注釈

Java EE 5 プラットフォームでは、サーブレットの仕様で要求される web.xml ファイルを除き、配備記述子を不要にすることによって配備を簡素化しています。 ejb-jar.xml のようなその他の配備記述子と、web.xml の Web サービスに関連するエントリは使用されていません。 J2EE 1.4 の配備記述子は、複雑になることが多く、記述時に誤りが起こりやすいものでした。 Java EE 5 プラットフォームでは、代わりに「注釈」を利用します。 注釈は public や private と同様に、コード内で指定する Java の修飾子です。 たとえば、Java EE 5 仕様のサブセットである EJB 3 仕様は、Bean の種類、インタフェースの種類、リソース参照、トランザクション属性、セキュリティーなどのための注釈を定義します。 JAX-WS 2.0 仕様も、Web サービスのためのよく似た注釈のセットを提供しています。 アーティファクトの生成に使用される注釈もあります。 また、コードの記録に使用される注釈もあります。 そのほかにも、セキュリティーや実行時に特有のロジックのような拡張サービスを提供するものがあります。 要約すると、Java EE 5 プラットフォームは、特に次の作業のための注釈を提供しているといえます。

• Web サービスの定義と使用
• EJB ソフトウェアアプリケーションの開発
• XML への Java テクノロジのクラスのマッピング
• データベースへの Java テクノロジのクラスのマッピング
• 操作へのメソッドのマッピング
• 外部依存関係の指定
• セキュリティー属性を含む配備情報の指定

注釈には @ 記号が付与されています。 IDE では、Java EE 5 の注釈を利用した型を作成すると、生成されたコード内に関連するプレースホルダが用意されます。 たとえば、IDE を使用してステートレスセッション Bean を作成すると、@Stateless() という注釈を含んだ次のコードが生成されます。

package mypackage;

import javax.ejb.*;

@Stateless()
public class HelloWorldSessionBean implements mypackage.HelloWorldSessionLocal {

}

各属性はデフォルト値を持っています。 そのため、デフォルト値以外の値を使用しない限り、どの属性の値も指定する必要はありません。 簡単な事例では、デフォルト値で十分に事足ります。これは、属性をまったく入力しなくてもよいことを意味します。

簡素化された EJB ソフトウェア開発

新しい EJB 3.0 API は、開発者に要求される作業の量を減らして簡素化することによって、ソフトウェア開発を容易にしています。 つまり、クラスの数とコードの量が少なくなっています。 これは、作業の多くがコンテナによって実行されるために可能になりました。 新しい EJB 3.0 API の機能と利点の一部を次に示します。

• 必要なクラスおよびインタフェースが減少。 必要なメソッドの公開はコンテナが担当するため、EJB コンポーネントのホームインタフェースおよびオブジェクトインタフェースは必要ありません。 ビジネスインタフェースを用意するだけで済みます。 EJB コンポーネントの宣言に注釈を使用することができ、コンテナがそのトランザクションを管理します。
• 配備記述子が不要。 以前は配備記述子で定義していた依存関係および設定についての指示を、直接クラス内で注釈を使用してコンテナに対して行うことができます。 特に指示がない場合、コンテナはデフォルト規則を使用して、ごく一般的な状況を処理します。
• 簡単なルックアップ。 EJBContext を使用して、クラス内の JNDI 名前空間にあるオブジェクトを直接検索できます。
• 簡素化されたオブジェクトリレーショナルマッピング。 新しい Java Persistence API により、POJO 内で注釈を使用して Java オブジェクトをリレーショナルデータベースにマッピングすることで、オブジェクトリレーショナルマッピングがより簡単で透過性の高いものになっています。

IDE では、ほかの Java クラスをコーディングするように、エンタープライズ Bean をコーディングすることができ、コード補完とエディタヒントを使用して、適切なメソッドを実装し、インタフェースでクラスの同期を維持することができます。 ビジネスメソッドまたは Web サービスオペレーションなどを生成するために特別なコマンドやダイアログを使用する必要はありません。ただし、コマンドは、ユーザーが Java EE 5 構文に慣れるまでのことを考慮し、まだ使用可能になっています。

依存関係インジェクションを使用した、リソースへのアクセス

リソースの注入を要求するために、コンポーネントは @Resource という注釈か、または、特別なリソースの場合には @EJB および @WebServiceRef という注釈を使用します。 注入できるリソースには、次のものがあります。

• SessionContext オブジェクト
• DataSources オブジェクト
• EntityManager インタフェース
• その他のエンタープライズ Bean
• Web サービス
• メッセージキューおよびトピック
• リソースアダプタのための接続ファクトリ

IDE では、Java EE 5 プラットフォームによって提供されるリソースインジェクションの注釈のための完全なコード補完の機能が、ソースエディタに用意されています。 また、「EJB の呼び出し」および「データベースを使用」などのコマンドを実行すると、IDE によって、ファイルにリソースが自動的に注入されます。

Java Persistence API モデル

Web サービス

Java EE 5 プラットフォームでは、注釈の使用によって Web サービスのサポートが大幅に向上され、簡素化されています。 この領域に関与する仕様には、JSR 224 (Java API for XML-Based Web Services (JAX-WS) 2.0)、JSR 222 (Java Architecture for XML Binding (JAXB) 2.0)、および JSR 181 (Web Services Metadata for the Java Platform) があります。