文档首页/ 消息&短信 MSGSMS/ SDK参考/ Java SDK使用指导
更新时间：2024-10-10 GMT+08:00
查看PDF
分享

Java SDK使用指导

MSGSMS提供Java语言的应用侧SDK供开发者使用。本文介绍Java SDK的安装和配置，及使用Java SDK调用API参考的示例，您可以参考本章节进行快速集成开发。

开发前准备

  • 已注册华为账号并开通华为云，完成企业实名认证。
  • 已具备Java开发环境 ，支持Java JDK 1.8及以上版本。
  • 已获取华为云账号对应的Access Key（AK）和Secret Access Key（SK）。

    请在华为云控制台“我的凭证 > 访问密钥”页面上创建和查看您的AK/SK。具体请参见访问密钥。

安装SDK

您可以通过Maven方式获取和安装SDK，首先需要在您的操作系统中下载并安装Maven ，安装完成后您只需要在Java项目的pom.xml文件中加入相应的依赖项即可。

使用SDK前，您需要安装“huaweicloud-sdk-core”和“huaweicloud-sdk-msgsms”，具体的SDK版本号请参见SDK开发中心。

以下代码示例中的version值，请根据实际的SDK版本号进行替换。

<dependency>
    <groupId>com.huaweicloud.sdk</groupId>
    <artifactId>huaweicloud-sdk-core</artifactId>
    <version>3.1.11</version>
</dependency>
<dependency>
    <groupId>com.huaweicloud.sdk</groupId>
    <artifactId>huaweicloud-sdk-msgsms</artifactId>
    <version>3.1.11</version>
</dependency>

代码示例

以调用创建短信应用接口为例，以下代码示例向您展示使用Java SDK的主要步骤：

  1. 创建认证。
  2. 创建MsgsmsClient实例并初始化。
  3. 实例化请求对象。
  4. 调用创建短信应用接口。 
    package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.msgsms.v2.region.MsgsmsRegion;
import com.huaweicloud.sdk.msgsms.v2.*;
import com.huaweicloud.sdk.msgsms.v2.model.*;


public class CreateAppSolution {

    public static void main(String[] args) {
         // 认证用的ak和sk直接写到代码中有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。
        // 本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量CLOUD_SDK_AK和CLOUD_SDK_SK。
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");

        // 创建认证
        ICredential auth = new BasicCredentials()
                .withAk(ak)
                .withSk(sk);
  
        // 创建MsgsmsClient实例并初始化
        MsgsmsClient client = MsgsmsClient.newBuilder()
                .withCredential(auth)
                .withRegion(MsgsmsRegion.valueOf("cn-north-4"))
                .build();
        // 实例化请求对象
        CreateAppRequest request = new CreateAppRequest();
        SmsAppAddReq body = new SmsAppAddReq();
        request.withBody(body);
        try {
            // 调用创建短信应用接口
            CreateAppResponse response = client.createApp(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

    参数

    说明

    ak

    您的华为云账号访问密钥ID（Access Key ID）。

    sk

    您的华为云账号秘密访问密钥（Secret Access Key）。

    MsgsmsRegion.valueOf("cn-north-4")

    请替换为您要访问的MSGSMS平台所在区域，当前MSGSMS支持访问的区域，在SDK代码MsgsmsRegion.java中已经定义。

    您可以在MSGSMS控制台页面左上角查看当前服务所在区域名称。

    项目源码及更多详细的使用指导请参考华为云Java软件开发工具包（Java SDK）。

    推荐您使用API在线调试工具API Explorer ，API Explorer支持快速调试和检索，调试API的同时，可以根据您的参数实时生成各种开发语言的SDK示例代码，方便您直接根据示例代码使用SDK。

相关文档