本文为您介绍火山引擎Java SDK的下载地址及安装方式。 ## 前提条件 * 您已注册火山引擎账号并完成实名认证，具体步骤，请参见 [账号注册](https://www.volcengine.com/docs/6261/64925) 及 [实名认证](https://www.volcengine.com/docs/6261/64935) 。 * 要使用火山引擎Java SDK访问指定服务的API ，请确认您已在 [火山引擎控制台](https://console.volcengine.com/home) 开通当前服务。 * 您已获取账号的AccessKey，具体步骤，请参见 [获取AccessKey](https://www.volcengine.com/docs/6291/65568) 。 * 您确认已安装Java JDK 1.7或以上版本，您可以下载最新版本： [http://developers.sun.com/downloads/](http://developers.sun.com/downloads/)。 ## SDK下载地址 Java SDK下载地址：[volcengine-java-sdk](https://github.com/volcengine/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仓库进行镜像设置，设置方法如下： ```xml # 请将如下设置加入到标签中 bytedanceMaven my-repo-id 字节跳动maven仓库 https://artifact.bytedance.com/repository/releases/ ``` ### 步骤二：配置Maven项目依赖新建一个Maven项目，在项目目录下的`pom.xml`中，添加如下设置，引入服务依赖。引入依赖后，Maven项目管理工具会自动下载相关jar包。 * 独立服务包您可以按需引入服务依赖，以VPC、ECS、EBS服务为例，您需要引入volcengine\-java\-sdk\-vpc、volcengine\-java\-sdk\-ecs和volcengine\-java\-sdk\-storageebs。 ```xml # com.volcengine volcengine-java-sdk-vpc 0.1.61 com.volcengine volcengine-java-sdk-ecs 0.1.61 com.volcengine volcengine-java-sdk-storageebs 0.1.61 ``` * 全部SDK包如果您需要引入SDK的全部服务，可以通过`bom`方式引入。如下文所示，引入volcengine\-java\-sdk\-bom后，即可引入所有支持的服务： ```xml com.volcengine volcengine-java-sdk-bom 0.1.61 pom import ``` ## 使用Java SDK 本文以查看指定NAT网关的信息为例，为您介绍如何使用Java SDK。新建`TestNat.java`文件，参考 [DescribeNatGatewayAttributes](https://www.volcengine.com/docs/6404/79665) 的请求参数说明，添加如下代码。 ```java /** * 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`中添加如下内容： ```xml javax.annotation javax.annotation-api 1.3.2 ```