本文介绍安装Java SDK的教程。

创建AccessKey

  1. 访问安全信息管理页面并登录阿里云账号。
  2. 创建AccessKey。更多信息请参见创建AccessKey

安装SDK

  • 开发环境:阿里云Java SDK支持J2SE Development Kit (JDK) 1.5或以上版本。
  • 安装步骤:
    1. 在解压的文件中可以找到aliyun-java-sdk-core-2.2.5.jar和aliyun-java-sdk-cf.jar两个包。
    2. 以Eclipse为例导入jar包:在Eclipse上右键单击工程->Properties->Java Build Path->Libraries->Add External JARs(netbeans和intellij等其他idea用户请自行按照相应导入jar包的方法导入这个包)。
    3. 选择上述的jar包,单击OK。

    经过以上步骤,您就可以在工程中使用阿里云Java SDK了。

快速入门

初始化一个IClientProfile。

  1. 与阿里云SDK相关的类都在包com.aliyuncs.IAcsClient下。
  2. IClientProfile是与API交互的接口,SDK的操作都是通过IClientProfile完成的。
  3. IClientProfile可以复用,建议设置成应用程序全局唯一的。
  4. 用户可以调用带有connectTimeout和readTimeout的构造方法来设置SDK调用接口的连接超时时间和读取超时时间,SDK默认的连接超时时间是3秒,读取超时时间是80秒。
String regionid = "cn-hangzhou";
String accessKeyId = "*** Provide your AccessKeyId ***";
String accessKeySecret = "*** Provide your AccessKeySecret ***";

// Create a new IClientProfile instance
IClientProfile client = DefaultProfile.getProfile(regionid, accessKeyId, accessKeySecret);			

示例代码

  • 风险识别API
public void test(){        
        SpamRegisterPreventionRequest request = new SpamRegisterPreventionRequest();
        // 必填参数
        request.setPhoneNumber("");
        request.setIp("客户端来源IP");
        request.setProtocolVersion("1.0.1");
        request.setSource(3); //注册来源。1:PC网页;2:移动网页;3:APP;4:其它。
        request.setJsToken(""); //对应前端页面的afs_token,source来源为1&2&4时,必填。
        request.setSDKToken("");//对应sdk中获取的wtoken,source来源为3时,必填。

        // 选填参数
        request.setEmail("");
        request.setUserId("");
        request.setIdType(1);
        request.setCurrentUrl("");
        request.setAgent("");
        request.setCookie("");
        request.setSessionId("");
        request.setMacAddress("");
        request.setReferer("");
        request.setNickName("");
        request.setCompanyName("");
        request.setAddress("");
        request.setIDNumber("");
        request.setBankCardNumber("");
        request.setExtendData("");

        try {
            SpamRegisterPreventionResponse response = client.getAcsResponse(request);
            // TODO
        } catch (Exception e) {
            e.printStackTrace();            
        }        
    }
			
  • 验证码服务API
public void test(){        
        AfsCheckRequest request = new AfsCheckRequest();
        request.setPlatform(3);//必填参数,请求来源: 1:Android端; 2:iOS端; 3:PC端及其他
        request.setSession("xxx");// 必填参数,从前端获取,不可更改
        request.setSig("xxx");// 必填参数,从前端获取,不可更改
        request.setToken("zxd");// 必填参数,从前端获取,不可更改
        request.setScene("xxx");// 必填参数,从前端获取,不可更改

        try {
            AfsCheckResponse response = client.getAcsResponse(request);
            // TODO
        } catch (Exception e) {
            e.printStackTrace();            
        }        
    }