com.dataify.sdk

类 TaskService

java.lang.Object

com.dataify.sdk.TaskService

public class TaskService
extends Object

Dataify 异步采集任务服务。 提供 Scraper Builder 任务状态查询和任务结果下载能力。

字段概要

字段

限定符和类型	字段和说明
static String	TYPE_CSV CSV 结果类型。
static String	TYPE_JSON JSON 结果类型。
static String	TYPE_XLSX XLSX 结果类型。

方法概要

限定符和类型	方法和说明
RawResponse	download(String taskId) 下载任务结果，默认使用 JSON 类型。
RawResponse	download(String taskId, String type) 下载指定类型的任务结果。
RawResponse	downloadCsv(String taskId) 下载 CSV 结果。
RawResponse	downloadJson(String taskId) 下载 JSON 结果。
RawResponse	downloadXlsx(String taskId) 下载 XLSX 结果。
RawResponse	status(String taskId) 查询 Scraper Builder 异步任务状态。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

TYPE_JSON

public static final String TYPE_JSON

JSON 结果类型。

另请参阅:

常量字段值

TYPE_CSV

public static final String TYPE_CSV

CSV 结果类型。

另请参阅:

常量字段值

TYPE_XLSX

public static final String TYPE_XLSX

XLSX 结果类型。

另请参阅:

常量字段值

方法详细资料

status

public RawResponse status(String taskId)
                   throws IOException

查询 Scraper Builder 异步任务状态。 上游接口为 GET /task_status，使用 api_key 和 task_id 查询参数。

参数:

taskId - 创建任务时返回的任务 ID

返回:

Dataify 原始响应，data.status 为 处理中、成功 或 失败

抛出:

IOException - 网络请求或响应读取失败时抛出

download

public RawResponse download(String taskId)
                     throws IOException

下载任务结果，默认使用 JSON 类型。

参数:

taskId - 创建任务时返回的任务 ID

返回:

Dataify 原始响应；JSON 结果可调用 string()，二进制结果应调用 bytes()

抛出:

IOException - 网络请求或响应读取失败时抛出

download

public RawResponse download(String taskId,
                            String type)
                     throws IOException

下载指定类型的任务结果。

参数:

taskId - 创建任务时返回的任务 ID

type - 下载类型：json、csv 或 xlsx

返回:

Dataify 原始响应；JSON、CSV 可调用 string()，XLSX 应调用 bytes()

抛出:

IOException - 网络请求或响应读取失败时抛出

downloadJson

public RawResponse downloadJson(String taskId)
                         throws IOException

下载 JSON 结果。

参数:

taskId - 创建任务时返回的任务 ID

返回:

JSON 原始响应

抛出:

IOException - 网络请求或响应读取失败时抛出

downloadCsv

public RawResponse downloadCsv(String taskId)
                        throws IOException

下载 CSV 结果。

参数:

taskId - 创建任务时返回的任务 ID

返回:

CSV 原始响应

抛出:

IOException - 网络请求或响应读取失败时抛出

downloadXlsx

public RawResponse downloadXlsx(String taskId)
                         throws IOException

下载 XLSX 结果。

参数:

taskId - 创建任务时返回的任务 ID

返回:

XLSX 二进制响应，使用 bytes() 读取

抛出:

IOException - 网络请求或响应读取失败时抛出