文档

准备环境

更新时间:

在运行收发消息的 Java 代码前,您需按照本文提供的步骤来准备环境。

操作步骤

  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_ENVSOFA_SK_ENV,并写入已准备好的AccessKey ID 和 AccessKey Secret。

      2. 重启 Windows 系统。

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

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

后续步骤

日志配置

更多信息

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