租户端 互联网中间件 分布式事务（DTF） 开发手册

准备工作

最近更新时间: 2024-06-12 15:06:00

环境要求

  • JDK：建议1.8.161或以上版本
  • Maven：建议3.5.2或以上版本
  • 网络：能够连接到公网即可

安装 Java

检查 Java 安装

打开终端，执行如下命令：

java -version

如果输出 Java 版本号，说明 Java 安装成功；如果没有安装 Java，请 下载安装 Java 软件开发套件（JDK）。

设置 Java 环境

设置JAVA_HOME环境变量，并指向您机器上的 Java 安装目录。 以 Java 1.6.0_21 版本为例，操作系统的输出如下：

操作系统 输出
Windows Set the environment variable JAVA_HOME to
C:\Program Files\Java\jdk1.6.0_21
Linux export JAVA_HOME=/usr/local/java-current
Mac OSX export JAVA_HOME=/Library/Java/Home

将 Java 编译器地址添加到系统路径中。

操作系统 输出
Windows 将字符串“;C:\Program Files\Java\jdk1.6.0_21\bin”添加到系统变量“Path”的末尾
Linux export PATH=$PATH:$JAVA_HOME/bin/
Mac OSX not required

使用上面提到的 java -version 命令验证 Java 安装。

安装 Maven

下载安装 Maven

参考 Maven 下载。

设置 MAVEN_HOME 和 PATH 环境变量

  • Windows 系统下
   新建系统变量   MAVEN_HOME  变量值：E:\Maven\apache-maven-3.3.9
   编辑系统变量  Path         添加变量值： ;%MAVEN_HOME%\bin
  • Linux、macOS 系统下
   export MAVEN_HOME=/usr/local/maven/apache-maven-3.3.9
   export PATH=$MAVEN_HOME/bin:$PATH

验证 Maven 安装

当 Maven 安装完成后， 通过执行如下命令验证 Maven 是否安装成功。

   mvn --version

若出现正常的版本号信息后，说明 Maven 安装成功。

配置 Maven 仓库

下载 示例工程 后，可以通过以下配置引入Maven 仓库，以便于自动获取 DTF 相关依赖。 在示例工程 中，pom.xml 所在目录执行 mvn clean package 即可下载 DTF SDK。

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <!-- localRepository
   | The path to the local repository maven will use to store artifacts.
   |
   | Default: ${user.home}/.m2/repository
  <localRepository>/path/to/local/repo</localRepository>
  -->

  <pluginGroups></pluginGroups>
  <proxies></proxies>
  <servers></servers>
  <mirrors></mirrors>

  <profiles>
    <profile>
        <id>qcloud-repo</id>
        <repositories>
            <repository>
                <id>qcloud-central</id>
                <name>qcloud mirror central</name>
                <url>http://mirrors.fincloud.tencent.cn/nexus/repository/maven-public/</url>
                <snapshots>
                    <enabled>true</enabled>
                </snapshots>
                <releases>
                    <enabled>true</enabled>
                </releases>
            </repository>
            </repositories>
        <pluginRepositories>
            <pluginRepository>
                <id>qcloud-plugin-central</id>
                <url>http://mirrors.fincloud.tencent.cn/nexus/repository/maven-public/</url>
                <snapshots>
                    <enabled>true</enabled>
                </snapshots>
                <releases>
                    <enabled>true</enabled>
                </releases>
            </pluginRepository>
        </pluginRepositories>
    </profile>
  </profiles>

  <activeProfiles>
    <activeProfile>qcloud-repo</activeProfile>
  </activeProfiles>
</settings>

获取API 密钥

使用 DTF 时，需要用户自行获取 访问密钥 信息（即 SecretId 和 SecretKey）。

获取事务分组 ID、TC 集群 IP 与端口

使用 DTF 时，需要用户自行 创建事务分组，并获取其 GroupId（事务分组 ID）、BorkerList（TC 集群 IP 与端口信息）。