操作步驟

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 用戶，以便于您控制權限，方便管理。

后續步驟

日志配置

更多信息

按照以上步驟準備好環境后，即可按需收發消息。

• 發送普通消息（三種方式）

• 發送消息（多線程）

• 收發順序消息

• 收發事務消息

• 收發延時消息

• 訂閱消息