現在、最も人気のあるフレームワークの構築の基礎となっているのは、依存関係の挿入です。これについて CDI 仕様に何が記載されているか、どのような基本機能があり、それらをどのように使用できるかを検討することをお勧めします。
![依存関係の注入についての簡単な説明、または]()
![依存関係の注入についての簡単な説明、または]()
その後、「数字を選択するかフィルターを適用してください」と「org.apache.maven.archetypes:maven-archetype-quickstart バージョンを選択してください」という質問で Enter キーを押すだけです。次に、プロジェクト識別子、いわゆる GAV を入力します ( 「命名規則ガイド」を参照)。
![依存関係の注入についての簡単な説明、または]()
プロジェクトの作成が成功すると、「BUILD SUCCESS」という文字が表示されます。これで、お気に入りの IDE でプロジェクトを開くことができます。
![依存関係の注入についての簡単な説明、または]()
ここでは、プロジェクトで CDI API を使用するという事実を Maven がどのように記述しているかを確認できます。API はアプリケーション プログラミング インターフェイス、つまり何らかのプログラミング インターフェイスです。私たちは、このインターフェイスの背後で何がどのように機能するかを気にすることなく、インターフェイスを操作します。API は、プロジェクトで使用を開始する jar アーカイブです。つまり、プロジェクトはこの jar に依存し始めます。したがって、このプロジェクトの CDI API は依存関係になります。Maven では、プロジェクトは POM.xml ファイル ( POM - プロジェクト オブジェクト モデル) に記述されます。依存関係は依存関係ブロックに記述されており、そこに新しいエントリを追加する必要があります。
![依存関係の注入についての簡単な説明、または]()
![Java-университет]()
![依存関係の注入についての簡単な説明、または]()
![依存関係の注入についての簡単な説明、または]()
![依存関係の注入についての簡単な説明、または]()
このファイルを取得するとすぐに、コードを含むアーティファクトは「Explicit Bean archive」と呼ばれるようになります。これで、ソフトウェアと XML という 2 つの別個の構成ができました。問題は、同じデータをロードすることです。たとえば、DataSource Bean 定義は 2 回ロードされ、プログラムは実行時にクラッシュします。CDI コンテナはこれらを 2 つの別個の Bean として認識します (ただし、実際にはこれらは同じクラスであり、CDI コンテナは約 2 回学習しました)。これを回避するには、次の 2 つのオプションがあります。
![依存関係の注入についての簡単な説明、または]()
![依存関係の注入についての簡単な説明、または]()
![依存関係の注入についての簡単な説明、または]()
![依存関係の注入についての簡単な説明、または]()
![依存関係の注入についての簡単な説明、または]()
![依存関係の注入についての簡単な説明、または]()
図からわかるように、いわゆるライフサイクル コールバックがあります。これらは、Bean のライフサイクルの特定の段階で特定のメソッドを呼び出すように CDI コンテナに指示するアノテーションです。例えば：
![依存関係の注入についての簡単な説明、または]()
導入
この短いレビューを CDI などについて取り上げたいと思います。これは何ですか？CDI は、コンテキストと依存性の注入の略です。これは、依存関係の挿入とコンテキストを説明する Java EE 仕様です。詳細については、Web サイトhttp://cdi-spec.orgを参照してください。CDI は仕様 (どのように機能するかの説明、一連のインターフェイス) であるため、CDI を使用するための実装も必要になります。そのような実装の 1 つは Weld です - http://weld.cdi-spec.org/ 依存関係を管理し、プロジェクトを作成するには、Maven を使用します - https://maven.apache.org それで、Maven がインストールされました。抽象的なことは理解できなくても、実際に理解していきます。これを行うには、Maven を使用してプロジェクトを作成します。コマンドラインを開き (Windows では、Win+R を使用して「ファイル名を指定して実行」ウィンドウを開いて cmd を実行できます)、Maven にすべてを実行してもらいます。このため、Maven にはアーキタイプと呼ばれる概念があります: Maven Archetype。
プロジェクトへの CDI の追加
はじめに、CDI には興味深い Web サイトhttp://www.cdi-spec.org/があることがわかりました。ダウンロード セクションがあり、必要なデータを含むテーブルが含まれています。
<dependency>
<groupId>javax.enterprise</groupId>
<artifactId>cdi-api</artifactId>
<version>2.0</version>
</dependency><dependency>
<groupId>org.jboss.weld.se</groupId>
<artifactId>weld-se-core</artifactId>
<version>3.0.5.Final</version>
</dependency>
CDIコンテナの初期化
CDI はメカニズムです。誰かがこのメカニズムを制御する必要があります。上ですでに説明したように、このようなマネージャーはコンテナーです。したがって、これを作成する必要がありますが、それ自体は SE 環境には表示されません。main メソッドに以下を追加しましょう。public static void main(String[] args) {
SeContainerInitializer initializer = SeContainerInitializer.newInstance();
initializer.addPackages(App.class.getPackage());
SeContainer container = initializer.initialize();
}
CDI Bean
それで、豆。CDI ビンとは何ですか? これは、いくつかのルールに従う Java クラスです。これらのルールは仕様の「 2.2. Bean の種類は何ですか? 」の章で説明されています。CDI Bean を App クラスと同じパッケージに追加しましょう。public class Logger {
public void print(String message) {
System.out.println(message);
}
}main。
Logger logger = container.select(Logger.class).get();
logger.print("Hello, World!");public class DateSource {
public String getDate() {
return new Date().toString();
}
}public class Logger {
@Inject
private DateSource dateSource;
public void print(String message) {
System.out.println(dateSource.getDate() + " : " + message);
}
}
名前解決またはタイプセーフ解決
通常、インターフェイスは実装されるオブジェクトのタイプとして使用され、CDI コンテナ自体がどの実装を選択するかを決定します。これは多くの理由で役立ちますが、それについては後で説明します。したがって、ロガーインターフェイスがあります。public interface Logger {
void print(String message);
}public class SystemOutLogger implements Logger {
@Inject
private DateSource dateSource;
public void print(String message) {
System.out.println(message);
}
}Logger logger = container.select(Logger.class).get(); この行は引き続きロガーによって受信されます。そして利点は、インターフェースを知るだけで済み、CDI コンテナーがすでに実装を考えてくれることです。ログをリモート ストレージのどこかに送信する 2 番目の実装があるとします。
public class NetworkLogger implements Logger {
@Override
public void print(String message) {
System.out.println("Send log message to remote log system");
}
}org.jboss.weld.exceptions.AmbiguousResolutionException: WELD-001335: Ambiguous dependencies for type Logger どちらかを選択することはできません。いくつかのバリエーションが用意されています。最も単純なものは、 CDI Bean の@Vetoedアノテーションで、CDI コンテナーがこのクラスを CDI Bean として認識しないようにします。しかし、もっと興味深いアプローチがあります。CDI Bean は、 Weld CDI ドキュメントの@Alternative「4.7. 代替」の章で説明されているアノテーションを使用して「代替」としてマークできます。それはどういう意味ですか？これは、明示的に使用すると言わない限り、選択されないことを意味します。これは Bean の代替バージョンです。NetworkLogger Bean を @Alternative としてマークしてみましょう。コードが再度実行され、SystemOutLogger によって使用されることがわかります。代替手段を有効にするには、 beans.xmlファイルが必要です。「 beans.xml、どこに入れればいいの?」という疑問が生じるかもしれません。したがって、ファイルを正しく配置しましょう。
- この行を削除し
initializer.addPackages(App.class.getPackage())、代替の指示を XML ファイルに追加します。
<beans
xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="
http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/beans_1_1.xsd">
<alternatives>
<class>ru.javarush.NetworkLogger</class>
</alternatives>
</beans>bean-discovery-mode値「none 」を持つ属性をBean のルート要素に追加し、プログラムで代替を指定します。
initializer.addPackages(App.class.getPackage());
initializer.selectAlternatives(NetworkLogger.class);@Priority(CDI 1.1 以降)。
予選
それとは別に、修飾子などについて議論する価値があります。修飾子は Bean の上の注釈によって示され、Bean の検索を絞り込みます。さらに詳しく。興味深いことに、どの CDI Bean にも、どのような場合でも少なくとも 1 つの修飾子 - があります@Any。Bean の上に修飾子を何も指定しなかった場合、CDI コンテナ自体が@Any修飾子 - に別の修飾子を追加します@Default。何かを指定した場合 (たとえば、@Any を明示的に指定した場合)、@Default 修飾子は自動的に追加されません。しかし、予選の利点は、独自の予選を作成できることです。修飾子はアノテーションとほとんど変わりません。本質的に、これは特別な方法で書かれた単なる注釈です。たとえば、プロトコル タイプとして Enum を入力できます。
public enum ProtocolType {
HTTP, HTTPS
}@Qualifier
@Retention(RUNTIME)
@Target({METHOD, FIELD, PARAMETER, TYPE})
public @interface Protocol {
ProtocolType value();
@Nonbinding String comment() default "";
}@Nonbindingとしてマークされたフィールドは、修飾子の決定に影響を与えないこと に注意してください。次に、修飾子を指定する必要があります。これは、Bean タイプの上 (CDI がその定義方法を認識できるように) および注入ポイントの上 (@Inject アノテーションが付いているため、この場所で注入のためにどの Bean を探すべきかを理解できるように) が示されます。たとえば、修飾子を使用してクラスを追加できます。簡単にするために、この記事では NetworkLogger 内で実行します。
public interface Sender {
void send(byte[] data);
}
@Protocol(ProtocolType.HTTP)
public static class HTTPSender implements Sender{
public void send(byte[] data) {
System.out.println("sended via HTTP");
}
}
@Protocol(ProtocolType.HTTPS)
public static class HTTPSSender implements Sender{
public void send(byte[] data) {
System.out.println("sended via HTTPS");
}
}@Inject
@Protocol(ProtocolType.HTTPS)
private Sender sender;Protocol protocol = new Protocol() {
@Override
public Class<? extends Annotation> annotationType() {
return Protocol.class;
}
@Override
public ProtocolType value() {
String value = "HTTP";
return ProtocolType.valueOf(value);
}
};
container.select(NetworkLogger.Sender.class, protocol).get().send(null);
プロデューサー
CDI のもう 1 つの便利な機能はプロデューサーです。これらは、一部の Bean が依存関係の注入を要求したときに呼び出される特別なメソッド (特別なアノテーションが付いています) です。詳細については、ドキュメントのセクション「2.2.3. プロデューサー メソッド」で説明されています。最も単純な例:@Produces
public Integer getRandomNumber() {
return new Random().nextInt(100);
}
インターセプター
インターセプターとは、業務に「干渉」するインターセプターのことです。CDI では、これは非常に明確に行われます。インタプリタ (またはインターセプタ) を使用してロギングを行う方法を見てみましょう。まず、インターセプターへのバインディングを記述する必要があります。多くのことと同様、これはアノテーションを使用して行われます。@Inherited
@InterceptorBinding
@Target({TYPE, METHOD})
@Retention(RUNTIME)
public @interface ConsoleLog {
}@InterceptorBinding) のバインディングであり、extends ( ) によって継承されることです@InterceptorBinding。次に、インターセプター自体を書いてみましょう。
@Interceptor
@ConsoleLog
public class LogInterceptor {
@AroundInvoke
public Object log(InvocationContext ic) throws Exception {
System.out.println("Invocation method: " + ic.getMethod().getName());
return ic.proceed();
}
}@ConsoleLog
public void print(String message) {<interceptors>
<class>ru.javarush.LogInterceptor</class>
</interceptors>
イベントとオブザーバー
CDI は、イベントとオブザーバーのモデルも提供します。ここでは、インターセプターほどすべてが明らかではありません。したがって、この場合のイベントは任意のクラスにすることができ、特別な説明は必要ありません。例えば：public class LogEvent {
Date date = new Date();
public String getDate() {
return date.toString();
}
}public class LogEventListener {
public void logEvent(@Observes LogEvent event){
System.out.println("Message Date: " + event.getDate());
}
}public class LogObserver {
@Inject
private Event<LogEvent> event;
public void observe(LogEvent logEvent) {
event.fire(logEvent);
}
}@Inject
private LogObserver observer;public void print(String message) {
observer.observe(new LogEvent());.fireAsyncアノテーションを使用します。@ObservesAsyncたとえば、すべてのイベントが異なるスレッドで実行される場合、1 つのスレッドが例外をスローすると、他のスレッドは他のイベントの作業を実行できるようになります。CDI のイベントの詳細については、通常どおり仕様の「10. イベント」の章を参照してください。
デコレーター
上で見てきたように、さまざまなデザインパターンが CDI ウィングの下に集められています。そして、ここにもう 1 つ、デコレータがあります。これは非常に興味深いことです。このクラスを見てみましょう:@Decorator
public abstract class LoggerDecorator implements Logger {
public final static String ANSI_GREEN = "\u001B[32m";
public static final String ANSI_RESET = "\u001B[0m";
@Inject
@Delegate
private Logger delegate;
@Override
public void print(String message) {
delegate.print(ANSI_GREEN + message + ANSI_RESET);
}
}@Delegate)。デコレータは CDI Bean にのみ関連付けることができ、CDI Bean 自体はインターセプタでもデコレータでもありません。例は仕様書「1.3.7. デコレータの例」にも記載されています。デコレーターは、インターセプターと同様に、オンにする必要があります。たとえば、Beans.xmlでは次のようになります。
<decorators>
<class>ru.javarush.LoggerDecorator</class>
</decorators>ライフサイクル
Bean には独自のライフサイクルがあります。次のようになります。
@PostConstruct
public void init() {
System.out.println("Inited");
}
GO TO FULL VERSION