Amazon MQ ブローカーへの Java アプリケーションの接続 - Amazon MQ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon MQ ブローカーへの Java アプリケーションの接続

Amazon MQ ActiveMQ ブローカーを作成したら、ブローカーにアプリケーションを接続できます。次の例は、Java Message Service (JMS) を使用してブローカーへの接続を作成し、キューを作成し、メッセージを送信する方法を示しています。完全な Java の実用例については、「Working Java Example」を参照してください。

ActiveMQ ブローカーには、さまざまな ActiveMQ クライアントを使用して接続できます。ActiveMQ クライアントを使用することをお勧めします。

前提条件

VPC 属性を有効にする

ブローカーが 内でアクセスできるようにするにはVPC、 enableDnsHostnamesおよび enableDnsSupport VPC 属性を有効にする必要があります。詳細については、「Amazon VPCユーザーガイドDNS」の「 のサポートVPC」を参照してください。

インバウンド接続を有効にする

次に、アプリケーションのインバウンド接続を有効にします。

  1. Amazon MQ コンソールにサインインします。

  2. ブローカーリストから、ブローカーの名前 ( などMyBroker) を選択します。

  3. リポジトリの [] MyBroker ページの「接続」セクションで、ブローカーのウェブコンソールとワイヤレベルのプロトコルのアドレスURLとポートを書き留めます。

  4. [Details] (詳細) セクションの [Security and network] (セキュリティとネットワーク) で、セキュリティグループの名前または Pencil icon indicating an edit or modification action. をクリックします。

    EC2 ダッシュボードのセキュリティグループページが表示されます。

  5. セキュリティグループのリストから、セキュリティグループを選択します。

  6. ページ下部で、[インバウンド] を選択し、次に [編集] を選択します。

  7. インバウンドルールの編集ダイアログボックスで、パブリックにアクセスできるようにするすべての URLまたはエンドポイントのルールを追加します (次の例は、ブローカーウェブコンソールでこれを行う方法を示しています)。

    1. [ルールの追加] を選択します。

    2. タイプ で、カスタム TCPを選択します。

    3. [Port Range] (ポート範囲) にはウェブコンソールポート (8162) を入力します。

    4. [Source] (ソース) では、[Custom] (カスタム) が選択された状態のままにしておき、ウェブコンソールにアクセスできるようにするシステムの IP アドレスを入力します (192.0.2.1 など)。

    5. [Save] (保存) をクリックします。

      これで、ブローカーはインバウンド接続を受け入れることができます。

Java の依存関係を追加する

activemq-client.jar パッケージと activemq-pool.jar パッケージを Java クラスパスに追加します。以下の例は、Maven プロジェクトの pom.xml ファイルにあるこれらの依存関係を示しています。

<dependencies> <dependency> <groupId>org.apache.activemq</groupId> <artifactId>activemq-client</artifactId> <version>5.15.16</version> </dependency> <dependency> <groupId>org.apache.activemq</groupId> <artifactId>activemq-pool</artifactId> <version>5.15.16</version> </dependency> </dependencies>

activemq-client.jar の詳細については、Apache ActiveMQ ドキュメントの「Initial Configuration」を参照してください。

重要

以下のコード例では、プロデューサーとコンシューマーが単一のスレッド内で実行されます。実稼働システム (またはブローカーインスタンスのフェイルオーバーをテストする) には、プロデューサーとコンシューマーが個別のホストまたはスレッドで実行されるようにしてください。

メッセージプロデューサーを作成してメッセージを送信する

メッセージプロデューサーを作成し、メッセージを受信するには、次の指示に従います。

  1. ブローカーのエンドポイントを使用してメッセージプロデューサーのJMSプールされた接続ファクトリを作成し、ファクトリに対して createConnectionメソッドを呼び出します。

    注記

    アクティブ/スタンバイブローカーの場合、Amazon MQ は 2 つの ActiveMQ ウェブコンソール を提供しますがURLs、一度にアクティブになるのURLは 1 つだけです。同様に、Amazon MQ はワイヤレベルプロトコルごとに 2 つのエンドポイントを提供しますが、ペアごとに一度に 1 つのエンドポイントしかアクティブになりません。-1 および -2 サフィックスは冗長ペアを表します。詳細については、「Amazon MQ for ActiveMQ ブローカーのデプロイオプション」を参照してください。

    ワイヤレベルプロトコルのエンドポイントについては、フェイルオーバートランスポートを使用することによって、アプリケーションがエンドポイントのどちらか一方に接続することを許可できます。

    // Create a connection factory. final ActiveMQConnectionFactory connectionFactory = new ActiveMQConnectionFactory(wireLevelEndpoint); // Pass the sign-in credentials. connectionFactory.setUserName(activeMqUsername); connectionFactory.setPassword(activeMqPassword); // Create a pooled connection factory. final PooledConnectionFactory pooledConnectionFactory = new PooledConnectionFactory(); pooledConnectionFactory.setConnectionFactory(connectionFactory); pooledConnectionFactory.setMaxConnections(10); // Establish a connection for the producer. final Connection producerConnection = pooledConnectionFactory.createConnection(); producerConnection.start(); // Close all connections in the pool. pooledConnectionFactory.clear();
    注記

    メッセージプロデューサーは、常に PooledConnectionFactory クラスを使用する必要があります。詳細については、「常に接続プールを使用する」を参照してください。

  2. セッション、MyQueue という名前のキュー、およびメッセージプロデューサーを作成します。

    // Create a session. final Session producerSession = producerConnection.createSession(false, Session.AUTO_ACKNOWLEDGE); // Create a queue named "MyQueue". final Destination producerDestination = producerSession.createQueue("MyQueue"); // Create a producer from the session to the queue. final MessageProducer producer = producerSession.createProducer(producerDestination); producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);
  3. メッセージ文字列 "Hello from Amazon MQ!" を作成してから、メッセージを送信します。

    // Create a message. final String text = "Hello from Amazon MQ!"; TextMessage producerMessage = producerSession.createTextMessage(text); // Send the message. producer.send(producerMessage); System.out.println("Message sent.");
  4. プロデューサーをクリーンアップします。

    producer.close(); producerSession.close(); producerConnection.close();

メッセージコンシューマーを作成してメッセージを受信する

メッセージプロデューサーを作成し、メッセージを受信するには、次の指示に従います。

  1. ブローカーのエンドポイントを使用してメッセージプロデューサーJMSの接続ファクトリを作成し、ファクトリに対して createConnectionメソッドを呼び出します。

    // Create a connection factory. final ActiveMQConnectionFactory connectionFactory = new ActiveMQConnectionFactory(wireLevelEndpoint); // Pass the sign-in credentials. connectionFactory.setUserName(activeMqUsername); connectionFactory.setPassword(activeMqPassword); // Establish a connection for the consumer. final Connection consumerConnection = connectionFactory.createConnection(); consumerConnection.start();
    注記

    メッセージコンシューマーには、PooledConnectionFactory クラスを一切使用しないでください。詳細については、「常に接続プールを使用する」を参照してください。

  2. セッション、MyQueue という名前のキュー、およびメッセージコンシューマーを作成します。

    // Create a session. final Session consumerSession = consumerConnection.createSession(false, Session.AUTO_ACKNOWLEDGE); // Create a queue named "MyQueue". final Destination consumerDestination = consumerSession.createQueue("MyQueue"); // Create a message consumer from the session to the queue. final MessageConsumer consumer = consumerSession.createConsumer(consumerDestination);
  3. メッセージの待機を開始し、メッセージの到着時にメッセージを受信します。

    // Begin to wait for messages. final Message consumerMessage = consumer.receive(1000); // Receive the message when it arrives. final TextMessage consumerTextMessage = (TextMessage) consumerMessage; System.out.println("Message received: " + consumerTextMessage.getText());
    注記

    AWS メッセージングサービス (Amazon などSQS) とは異なり、コンシューマーは常にブローカーに接続されています。

  4. コンシューマー、セッション、および接続を閉じます。

    consumer.close(); consumerSession.close(); consumerConnection.close();