ApsaraMQ for RocketMQ は、Apache RocketMQ 5.x SDK をベースにした 2 つの Java SDK オプションを提供します。本ガイドを参考に、メッセージの送受信に適した SDK とバージョンを選択してください。
Apache RocketMQ 5.x SDK for Java には 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 reference overview をご参照ください。
推奨バージョン
gRPC プロトコル SDK
これらのバージョンは gRPC v2 プロトコルをサポートしており、Alibaba Cloud のエンジニアがテスト・検証済みです。
直接依存 (Maven)
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-client-java</artifactId>
<version>5.2.2</version>
</dependency>直接依存 (Gradle Kotlin DSL)
implementation("org.apache.rocketmq:rocketmq-client-java:5.2.2")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.1 を推奨します。 -->
<version>2.3.1</version>
</dependency>過去のバージョン
公開済みのすべてのバージョンを確認するには、Maven Central のリリースページをご参照ください。
gRPC プロトコル SDK:rocketmq-client-java releases
Remoting プロトコル SDK:rocketmq-client releases
Remoting プロトコル用 Spring Boot Starter:rocketmq-spring-boot-starter releases