准备环境

操作步骤

1. 通过 Maven 方式引入依赖。Java SDK 的最新版本号，可参见 SDK 版本说明。

   <dependency>
       <groupId>com.alipay.sofa</groupId>
       <artifactId>sofamq-client-all</artifactId>
       <version>"XXX"</version>
       //设置为 Java SDK 的最新版本号
   </dependency>
   <repositories>
       <repository>
           <id>antcloudrelease</id>
           <name>Ant Cloud</name>
           <url>http://mvn.cloud.alipay.com/nexus/content/groups/open</url>
       </repository>
   </repositories>

2. 创建资源。

   您需要先到控制台创建所需资源，包括消息队列的工作空间、Topic、Group ID（GID），以及鉴权需要的 AccessKey（AK）。具体操作请参见 快速入门。

3. 配置访问凭证。

   对接中间件时，因考虑安全问题，您必须做好应用的身份认证，避免非法访问，因此您需要在应用所在机器的环境变量参数中配置账号的 AccessKey、AccessSecret 信息。

   操作步骤如下：

   • Linux 和 macOS 系统配置方法

     执行以下命令：

     export SOFA_AK_ENV=<access_key_id>
     export SOFA_SK_ENV=<access_key_secret>

     <access_key_id> 替换为已准备好的 AccessKey ID，<access_key_secret> 替换为 AccessKey Secret。

   • Windows 系统配置方法

     1. 新建环境变量文件，添加环境变量 SOFA_AK_ENV 和 SOFA_SK_ENV，并写入已准备好的AccessKey ID 和 AccessKey Secret。

     2. 重启 Windows 系统。

   重要

   • 禁止使用阿里云账号 AccessKey，因为阿里云账号 AccessKey 泄露会威胁您所有资源的安全。请使用 RAM 用户 AccessKey 进行操作，可有效降低 AccessKey 泄露的风险。

   • 生产环境中，建议单独为中间件创建一个 RAM 用户，以便于您控制权限，方便管理。

后续步骤

日志配置

更多信息

按照以上步骤准备好环境后，即可按需收发消息。

• 发送普通消息（三种方式）

• 发送消息（多线程）

• 收发顺序消息

• 收发事务消息

• 收发延时消息

• 订阅消息