本文介绍如何使用Java SDK文件审核接口,检测文件中的文字和图片信息。

功能描述

文件审核目前只支持异步检测(异步检测不会实时返回检测结果)任务。关于参数的详细说明,请参见提交文件检测任务

前提条件

  • 安装Java依赖。关于安装Java依赖的具体操作,请参见安装Java依赖
    说明 请一定按照安装Java依赖页面中的版本安装,否则会导致调用失败。
  • 如果使用本地文件或者二进制文件检测,请下载并在项目工程中引入Extension.Uploader工具类

提交文件异步检测任务

接口 描述 支持的地域
FileAsyncScanRequest 提交文件异步检测任务,对文件中的文字和图片进行检测。
  • cn-shanghai:华东2(上海)
  • cn-beijing:华北2(北京)
示例代码
import Common.Constant;
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.green.model.v20180509.FileAsyncScanRequest;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;

import java.util.Arrays;
import java.util.UUID;

public class FileAsyncRequestSample {

    public static void main(String[] args) throws Exception {
        IClientProfile profile = DefaultProfile.getProfile("cn-shanghai", "请填写您的accessKeyId", "请填写您的accessKeySecret");
        DefaultProfile
                .addEndpoint("cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
        IAcsClient client = new DefaultAcsClient(profile);

        FileAsyncScanRequest fileAsyncScanRequest = new FileAsyncScanRequest();
        // 指定API返回格式。
        fileAsyncScanRequest.setAcceptFormat(FormatType.JSON);
        // 指定请求方法。
        fileAsyncScanRequest.setMethod(com.aliyuncs.http.MethodType.POST);
        fileAsyncScanRequest.setEncoding("utf-8");
        // textScenes:检测内容包含文本时,指定检测场景,取值:antispam。imageScenes:检测内容包含图片时,指定检测场景。
        JSONObject data = new JSONObject();
        data.put("textScenes", Arrays.asList("antispam"));
        data.put("imageScenes", Arrays.asList("porn", "ad"));
        JSONObject task = new JSONObject();
        task.put("dataId", "检测数据ID");
        task.put("url", "文件链接");
        data.put("tasks", Arrays.asList(task));
        fileAsyncScanRequest.setHttpContent(org.apache.commons.codec.binary.StringUtils.getBytesUtf8(data.toJSONString()),
                "UTF-8", FormatType.JSON);

        /**
         * 请设置超时时间, 服务端全链路处理超时时间为10秒,请做相应设置。
         * 如果您设置的ReadTimeout小于服务端处理的时间,程序中会获得一个ReadTimeout异常。
         */
        fileAsyncScanRequest.setConnectTimeout(3000);
        fileAsyncScanRequest.setReadTimeout(10000);
        HttpResponse httpResponse = null;
        try {
            httpResponse = client.doAction(fileAsyncScanRequest);
        } catch (Exception e) {
            e.printStackTrace();
        }

        if (httpResponse != null && httpResponse.isSuccess()) {
            JSONObject scrResponse = JSON.parseObject(org.apache.commons.codec.binary.StringUtils.newStringUtf8(httpResponse.getHttpContent()));
            System.out.println(JSON.toJSONString(scrResponse, true));
        }
    }
}

获取文件异步检测任务结果

接口 描述 支持的Region
FileAsyncScanResultsRequest 获取文件异步检测结果。
  • cn-shanghai:华东2(上海)
  • cn-beijing:华北2(北京)
示例代码
import Common.Constant;
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.green.model.v20180509.FileAsyncScanResultsRequest;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;

import java.util.Arrays;

public class FileAsyncResultSample {

    public static void main(String[] args) throws Exception {
        IClientProfile profile = DefaultProfile.getProfile("cn-shanghai", "请填写您的AccessKey ID", "请填写您的AccessKey Secret");
        DefaultProfile
                .addEndpoint("cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
        IAcsClient client = new DefaultAcsClient(profile);

        FileAsyncScanResultsRequest fileAsyncScanResultsRequest = new FileAsyncScanResultsRequest();
        // 指定API返回格式。
        fileAsyncScanResultsRequest.setAcceptFormat(FormatType.JSON);
        // 指定请求方法。
        fileAsyncScanResultsRequest.setMethod(com.aliyuncs.http.MethodType.POST);
        fileAsyncScanResultsRequest.setEncoding("utf-8");

        JSONObject data = new JSONObject();
        data.put("taskIds", Arrays.asList("文件审核任务ID"));

        fileAsyncScanResultsRequest.setHttpContent(org.apache.commons.codec.binary.StringUtils.getBytesUtf8(data.toJSONString()),
                "UTF-8", FormatType.JSON);

        /**
         * 请设置超时时间, 服务端全链路处理超时时间为10秒,请做相应设置。
         * 如果您设置的ReadTimeout小于服务端处理的时间,程序中会获得一个ReadTimeout异常。
         */
        fileAsyncScanResultsRequest.setConnectTimeout(3000);
        fileAsyncScanResultsRequest.setReadTimeout(10000);
        HttpResponse httpResponse = null;
        try {
            httpResponse = client.doAction(fileAsyncScanResultsRequest);
        } catch (Exception e) {
            e.printStackTrace();
        }

        if (httpResponse != null && httpResponse.isSuccess()) {
            JSONObject scrResponse = JSON.parseObject(org.apache.commons.codec.binary.StringUtils.newStringUtf8(httpResponse.getHttpContent()));
            System.out.println(JSON.toJSONString(scrResponse, true));
        }
    }
}