iCloud.recordFetchMultiple()

概述

检索多个记录。逐记录结果将传递给 onRecord 监听器函数，最终结果将作为 iCloudRecordEvent 传递给 onComplete 监听器函数。

语法

iCloud.recordFetchMultiple( params )

参数参考

对于 params 表而言，有效键包括

• recordNameArray — 必需 表，包含待获取记录标识符列表或包含记录标识符和分区详细信息的 表 数组。按如下方式传递此值

recordNameArray = { "r1", "r2", "r3" }

recordNameArray = {
    { recordName="r1", zoneName="z1", zoneOwner="o1" },
    { recordName="r2", zoneName="z2", zoneOwner="o2" }
}

• onComplete — 必需的 侦听器 函数，该函数将调用 iCloudRecordEvent 来处理整体获取请求。

• onRecord — 可选 监听器 函数，该函数将调用 iCloudRecordEvent 来处理获取请求中的每个记录。

• database — 可选 字符串 值，指示数据库。

• containerId — 可选 字符串 值，指示包含记录的特定 iCloud 容器。如果您仅有一个与其应用程序关联的 iCloud 容器，则不要传递此参数。

示例

-- Listener function to handle per-record events
local function recordFetched( event )

    print( event.record )      -- Specific fetched record
    print( event.isError )     -- Indicates whether an error occurred
    print( event.recordName )  -- If an error occurred, identifies the record involved
    print( event.error )       -- Description of the error which occurred, if any
end

-- Listener function to handle the overall fetch request
local function fetchResults( event )

    print( event.recordArray )  -- Array of successfully retrieved records
    print( event.isError )      -- Indicates whether an error occurred
    print( event.error )        -- Description of the error which occurred, if any
end

iCloud.recordFetchMultiple(
    {
        recordNameArray = { "r1", "r2", "r3" },
        onRecord = recordFetched,
        onComplete = fetchResults
    }
)