Java安装指导--NAT网关-火山引擎

文档中心

立即注册

导航

Java安装指导

最近更新时间：2023.09.04 19:15:49首次发布时间：2023.06.09 11:16:54

本文为您介绍火山引擎Java SDK的下载地址及安装方式。

前提条件

您已注册火山引擎账号并完成实名认证，具体步骤，请参见账号注册及实名认证。
要使用火山引擎Java SDK访问指定服务的API ，请确认您已在火山引擎控制台开通当前服务。
您已获取账号的AccessKey，具体步骤，请参见获取AccessKey 。
您确认已安装Java JDK 1.7或以上版本，您可以下载最新版本： http://developers.sun.com/downloads/。

SDK下载地址

Java SDK下载地址：volcengine-java-sdk

安装SDK

步骤一：设置字节跳动Maven镜像仓库（可选）

当SDK版本大于或者等于0.1.28时，volcengine-java-sdk会在Maven中央仓库发布，您可以无需执行本步骤。但字节跳动的Maven仓库更新时间会比Maven中央仓库提早几个小时，您也可以按需选用字节跳动的Maven仓库。
当SDK版本小于0.1.28时，volcengine-java-sdk并未在Maven中央仓库发布，而是在字节跳动对外的Maven仓库发布，因此您在使用前，请先在Maven的安装目录conf/settings.xml中，针对字节跳动的Maven仓库进行镜像设置，设置方法如下：

# 请将如下设置加入到 <mirror>标签中

<mirror>
     <id>bytedanceMaven</id>
     <mirrorOf>my-repo-id</mirrorOf>
     <name>字节跳动maven仓库</name>
     <url>https://artifact.bytedance.com/repository/releases/</url>
</mirror>

步骤二：配置Maven项目依赖

新建一个Maven项目，在项目目录下的pom.xml中，添加如下设置，引入服务依赖。引入依赖后，Maven项目管理工具会自动下载相关jar包。

独立服务包

您可以按需引入服务依赖，以VPC、ECS、EBS服务为例，您需要引入volcengine-java-sdk-vpc、volcengine-java-sdk-ecs和volcengine-java-sdk-storageebs。

# 
<dependencies>
    <dependency>
        <groupId>com.volcengine</groupId>
        <artifactId>volcengine-java-sdk-vpc</artifactId>
        <version>0.1.61</version>
    </dependency>
    <dependency>
        <groupId>com.volcengine</groupId>
        <artifactId>volcengine-java-sdk-ecs</artifactId>
        <version>0.1.61</version>
    </dependency>
    <dependency>
        <groupId>com.volcengine</groupId>
        <artifactId>volcengine-java-sdk-storageebs</artifactId>
        <version>0.1.61</version>
    </dependency>
</dependencies>

全部SDK包

如果您需要引入SDK的全部服务，可以通过bom方式引入。如下文所示，引入volcengine-java-sdk-bom后，即可引入所有支持的服务：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.volcengine</groupId>
            <artifactId>volcengine-java-sdk-bom</artifactId>
            <version>0.1.61</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

使用Java SDK

本文以查看指定NAT网关的信息为例，为您介绍如何使用Java SDK。
新建TestNat.java文件，参考 DescribeNatGatewayAttributes 的请求参数说明，添加如下代码。

/**
* Example Code generated by Beijing Volcanoengine Technology.
*/
package com.volcengine.natgateway.examples;

import com.volcengine.ApiClient;
import com.volcengine.ApiException;
import com.volcengine.sign.Credentials;

import com.volcengine.natgateway.NatgatewayApi;
import com.volcengine.natgateway.model.*;


public class TestDescribeNatGatewayAttributes {
    public static void main(String[] args) throws Exception {
        // 设置您的ak
        String ak = "Your AK";
        // 设置您的sk
        String sk = "Your SK";
        // 设置您要访问的地域，本示例为北京地域
        String region = "cn-beijing";

			  // 初始化apiclient
        ApiClient apiClient = new ApiClient()
                .setCredentials(Credentials.getCredentials(ak, sk))
                .setRegion(region);

        NatgatewayApi api = new NatgatewayApi(apiClient);
        
        // 创建一个DescribeNatGatewayAttributes接口
        DescribeNatGatewayAttributesRequest describeNatGatewayAttributesRequest = new DescribeNatGatewayAttributesRequest();
        // 设置接口入参，本示例仅传入实例ID，即NatGatewayId
        describeNatGatewayAttributesRequest.setNatGatewayId("ngw-2fesmko5zhdz459gp67sc****");

        // 发起请求并处理返回或异常
        try {
            DescribeNatGatewayAttributesResponse response = api.describeNatGatewayAttributes(describeNatGatewayAttributesRequest);
            System.out.println(response);
        } catch (ApiException e) {
            System.out.println(e.getResponseBody());
        }
    }
}

附录：关于Java JDK 9+的特殊说明

如果您的Java版本高于或者等于JDK 9，则需要依赖javax.annotation-api，请在pom.xml中添加如下内容：

<dependency>
  <groupId>javax.annotation</groupId>
  <artifactId>javax.annotation-api</artifactId>
  <version>1.3.2</version>
</dependency>