ApsaraMQ for RocketMQ は、Apache RocketMQ 5.x SDK に基づく 2 種類の Java SDK オプションを提供します。このガイドを使用して、メッセージの送受信に適した SDK とバージョンを選択してください。
Apache RocketMQ 5.x Java 用 SDK には、JDK 1.8 以降が必要です。
プロトコルの選択
ApsaraMQ for RocketMQ は 2 つの SDK プロトコルをサポートします。プロジェクトに適したものを選択してください:
gRPC プロトコル (推奨) | Remoting プロトコル | |
アーティファクト |
|
|
最適な用途 | 新規プロジェクト | Remoting プロトコルをすでに使用している既存のアプリケーション |
パフォーマンス | 最適なパフォーマンスとユーザーエクスペリエンス | オープンソースの Apache RocketMQ SDK を使用 |
Spring Boot |
|
|
ヒント: SDK が使用するプロトコルを特定するには、アーティファクト ID を確認してください。
rocketmq-client-javaは gRPC を使用し、rocketmq-clientは Remoting を使用します。新規アプリケーションでは、最適なパフォーマンスとユーザーエクスペリエンスのために gRPC v2 プロトコル SDK を使用してください。SDK の選定については、「SDK リファレンス概要」をご参照ください。
推奨バージョン
gRPC プロトコル SDK
これらのバージョンは gRPC v2 プロトコルをサポートしており、Alibaba Cloud のエンジニアがテストと検証を行っています。
直接の依存関係 (Maven)
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-client-java</artifactId>
<version>5.0.7</version>
</dependency>直接の依存関係 (Gradle Kotlin DSL)
implementation("org.apache.rocketmq:rocketmq-client-java:5.0.7")RocketMQ-Spring の依存関係
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-v5-client-spring-boot-starter</artifactId>
<!-- バージョン 2.3.6 (最小 2.2.2) を推奨します。以前のバージョンにはメッセージの送受信に関するバグがあります。可能な限り早くアップグレードしてください。 -->
<version>2.3.6</version>
</dependency>Remoting プロトコル SDK
直接の依存関係 (Maven)
クライアントと ACL の両方のアーティファクトを追加してください:
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-client</artifactId>
<version>5.3.1</version>
</dependency>
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-acl</artifactId>
<version>5.3.1</version>
</dependency>直接の依存関係 (Gradle Kotlin DSL)
implementation("org.apache.rocketmq:rocketmq-client:5.3.1")
implementation("org.apache.rocketmq:rocketmq-acl:5.3.1")RocketMQ-Spring の依存関係
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-spring-boot-starter</artifactId>
<!-- バージョン 2.3.6 (最小 2.2.2) を推奨します。以前のバージョンにはメッセージの送受信に関するバグがあります。可能な限り早くアップグレードしてください。 -->
<version>2.3.6</version>
</dependency>過去のバージョン
公開済みのすべてのバージョンを確認するには、Maven Central のリリースページを参照してください:
gRPC プロトコル SDK: rocketmq-client-java releases
Remoting プロトコル SDK: rocketmq-client releases
RocketMQ Spring SDK: rocketmq-spring releases