O ApsaraMQ for RocketMQ oferece duas opções de SDK para Java baseadas no Apache RocketMQ 5.x SDK. Use este guia para escolher o SDK e a versão adequados para enviar e receber mensagens.
O Apache RocketMQ 5.x SDK para Java requer JDK 1.8 ou superior.
Escolha um protocolo
O ApsaraMQ for RocketMQ é compatível com dois protocolos de SDK. Selecione o mais adequado ao seu projeto:
|
Protocolo gRPC (recomendado) |
Protocolo Remoting |
|
|
Artifact |
|
|
|
Mais indicado para |
Novos projetos |
Aplicações existentes que já usam o protocolo Remoting |
|
Desempenho |
Desempenho e experiência do usuário otimizados |
Usa o SDK open-source do Apache RocketMQ |
|
Spring Boot |
Compatível via |
Compatível via |
Dica: Para identificar o protocolo de um SDK, verifique seu artifact ID. O
rocketmq-client-javausa gRPC; orocketmq-clientusa Remoting.Para novas aplicações, use o SDK com protocolo gRPC v2 para garantir desempenho e experiência do usuário otimizados. Para obter detalhes sobre a seleção de SDK, consulte Visão geral da referência de SDK.
Versões recomendadas
SDK com protocolo gRPC
Estas versões são compatíveis com o protocolo gRPC v2 e foram testadas e validadas pelos engenheiros da Alibaba Cloud.
Dependência direta (Maven)
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-client-java</artifactId>
<version>5.0.7</version>
</dependency>
Dependência direta (Gradle Kotlin DSL)
implementation("org.apache.rocketmq:rocketmq-client-java:5.0.7")
Dependência do RocketMQ-Spring
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-v5-client-spring-boot-starter</artifactId>
<!-- We recommend version 2.3.6 (minimum 2.2.2). Earlier versions have message send/receive bugs. Upgrade as soon as possible. -->
<version>2.3.6</version>
</dependency>
SDK com protocolo Remoting
Dependência direta (Maven)
Adicione os artifacts do cliente e de 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>
Dependência direta (Gradle Kotlin DSL)
implementation("org.apache.rocketmq:rocketmq-client:5.3.1")
implementation("org.apache.rocketmq:rocketmq-acl:5.3.1")
Dependência do RocketMQ-Spring
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-spring-boot-starter</artifactId>
<!-- We recommend version 2.3.6 (minimum 2.2.2). Earlier versions have message send/receive bugs. Upgrade as soon as possible. -->
<version>2.3.6</version>
</dependency>
Histórico de versões
Para visualizar todas as versões publicadas, consulte as páginas de release no Maven Central:
SDK com protocolo gRPC: Releases do rocketmq-client-java
SDK com protocolo Remoting: Releases do rocketmq-client
RocketMQ Spring SDK: Releases do rocketmq-spring.