---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# ページネータークラス: Android

# ページネータークラス: Android {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：11分

Paginator クラスには、NowTableService クラスによって返される結果など、REST エンドポイント呼び出しによって返される結果をページングするための関数が用意されています。

最初に [NowTableService - paginator(from tableName: String, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_O "レコードのページを反復処理できるページネーターを作成します。") または [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") 関数を呼び出して、ページネーションの戻り値の結果を取得する必要があります。

## ページネーター - first() {#ariaid-title2}

返された結果の最初のページをフェッチします。
このメソッドは、最初のページを取得できない場合、 `PaginationError` をスローします。
{#PaginatorAnd-first__table_fpc_bgv_kqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 1. パラメーター]

{#PaginatorAnd-first__table_fpc_bgv_kqb} {#PaginatorAnd-first__table_gpc_bgv_kqb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 2. 返される内容]

{#PaginatorAnd-first__table_gpc_bgv_kqb}  
次のコード例は、この関数を呼び出す方法を示しています。

    suspend fun createAttachmentMetadataPaginator() {
      val paginator = nowServiceManager.getNowAttachmentService()?.attachmentMetadataPaginator(null, 10)
        ?.observe(object : PaginatorCallBack<NowAttachmentMetadata> {
          override fun onFailure(e: NowDataError) {
            handleError(e)
          }

          override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
            handleResponse(response)
          }

        })
        ?: throw Exception("Response is null")

      paginator.first()
    }

## ページネーター - hasNext() {#ariaid-title3}

返された結果に次のページがあるかどうかを確認します。
{#PaginatorAnd-hasNext__table_fxz_rww_rqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 3. パラメーター]

{#PaginatorAnd-hasNext__table_fxz_rww_rqb} {#PaginatorAnd-hasNext__table_gxz_rww_rqb__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 返される結果に次のページがあるかどうかを示すフラグ。 可能な値： * true:次のページが使用可能です。 * false:利用可能な次のページはありません。 |
[表 : 4. 返される内容]

{#PaginatorAnd-hasNext__table_gxz_rww_rqb}  
次のコード例は、この関数を呼び出す方法を示しています。

    suspend fun createAttachmentMetadataPaginator() {
      val paginator = nowServiceManager.getNowAttachmentService()?.attachmentMetadataPaginator(null, 10)
        ?.observe(object : PaginatorCallBack<NowAttachmentMetadata> {
          override fun onFailure(e: NowDataError) {
            handleError(e)
          }

          override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
            handleResponse(response)
          }

        })
        ?: throw Exception("Response is null")

      if (paginator.hasNext() && !paginator.isBusy()) {
        paginator.next()
      }
    }

## ページネーター - hasPrevious() {#ariaid-title4}

返された結果に前のページがあるかどうかを確認します。
{#PaginatorAnd-hasPrevious__table_qy4_dxw_rqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 5. パラメーター]

{#PaginatorAnd-hasPrevious__table_qy4_dxw_rqb} {#PaginatorAnd-hasPrevious__table_ry4_dxw_rqb__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 返される結果に前のページがあるかどうかを示すフラグ。 可能な値： * true:前のページが使用可能です。 * false:前のページは利用できません。 |
[表 : 6. 返される内容]

{#PaginatorAnd-hasPrevious__table_ry4_dxw_rqb}  
次のコード例は、この関数を呼び出す方法を示しています。

    suspend fun createAttachmentMetadataPaginator() {
      val paginator = nowServiceManager.getNowAttachmentService()?.attachmentMetadataPaginator(null, 10)
        ?.observe(object : PaginatorCallBack<NowAttachmentMetadata> {
          override fun onFailure(e: NowDataError) {
            handleError(e)
          }

          override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
            handleResponse(response)
          }

        })
        ?: throw Exception("Response is null")

      if (paginator.hasPrevious() && !paginator.isBusy()) {
        paginator.previous()
      }
    }

## ページネーター - isBusy() {#ariaid-title5}

ページネーターがデータのフェッチでビジー状態かどうかを確認します。
{#PaginatorAnd-isBusy__table_w3d_cyw_rqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 7. パラメーター]

{#PaginatorAnd-isBusy__table_w3d_cyw_rqb} {#PaginatorAnd-isBusy__table_x3d_cyw_rqb__entry__2}

| タイプ | 説明 |
|-|-|
| なし | ページネーターがデータのフェッチでビジー状態かどうかを示すフラグ。 可能な値： * true:データのフェッチがビジー状態です。 * false:ビジー状態ではありません。 |
[表 : 8. 返される内容]

{#PaginatorAnd-isBusy__table_x3d_cyw_rqb}  
次のコード例は、この関数を呼び出す方法を示しています。

    suspend fun createAttachmentMetadataPaginator() {
      val paginator = nowServiceManager.getNowAttachmentService()?.attachmentMetadataPaginator(null, 10)
        ?.observe(object : PaginatorCallBack<NowAttachmentMetadata> {
          override fun onFailure(e: NowDataError) {
            handleError(e)
          }

          override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
            handleResponse(response)
          }

        })
        ?: throw Exception("Response is null")

      if (paginator.hasNext() && !paginator.isBusy()) {
        paginator.next()
      }
    }

## ページネーター - last() {#ariaid-title6}

返された結果の最後のページをフェッチします。
このメソッドは、最後のページを取得できない場合、 `PaginationError` をスローします。
{#PaginatorAnd-last__table_ipy_hgv_kqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 9. パラメーター]

{#PaginatorAnd-last__table_ipy_hgv_kqb} {#PaginatorAnd-last__table_jpy_hgv_kqb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 10. 返される内容]

{#PaginatorAnd-last__table_jpy_hgv_kqb}  
次のコード例は、この関数を呼び出す方法を示しています。

    suspend fun createAttachmentMetadataPaginator() {
      val paginator = nowServiceManager.getNowAttachmentService()?.attachmentMetadataPaginator(null, 10)
        ?.observe(object : PaginatorCallBack<NowAttachmentMetadata> {
          override fun onFailure(e: NowDataError) {
            handleError(e)
          }

          override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
            handleResponse(response)
          }

        })
        ?: throw Exception("Response is null")

      if !paginator.isBusy()) {
        paginator.last()
      }
    }

## ページネーター - next() {#ariaid-title7}

返された結果の次のページをフェッチします。
フェッチするページがこれ以上ない場合、このメソッドは `PaginationError` をスローします。
{#PaginatorAnd-next__table_kj5_5cv_kqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 11. パラメーター]

{#PaginatorAnd-next__table_kj5_5cv_kqb} {#PaginatorAnd-next__table_lj5_5cv_kqb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 12. 返される内容]

{#PaginatorAnd-next__table_lj5_5cv_kqb}  
次のコード例は、この関数を呼び出す方法を示しています。

    suspend fun createAttachmentMetadataPaginator() {
      val paginator = nowServiceManager.getNowAttachmentService()?.attachmentMetadataPaginator(null, 10)
        ?.observe(object : PaginatorCallBack<NowAttachmentMetadata> {
          override fun onFailure(e: NowDataError) {
            handleError(e)
          }

          override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
            handleResponse(response)
          }

        })
        ?: throw Exception("Response is null")

      if (paginator.hasNext() && !paginator.isBusy()) {
        paginator.next()
      }
    }

## ページネーター - observe(callback: PaginatorCallBack\<T\>) {#ariaid-title8}

Paginator オブジェクトのコールバックを設定します。このメソッドは、他のPaginator関数を呼び出す前に呼び出す必要があります。
{#PaginatorAnd-observe_O__table_yj5_yyw_rqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| コールバック | ページネーターコールバック | ページネーターの作成の成功または失敗に基づいて呼び出すコールバック。 * 成功: `abstract fun onSuccess(response: Response<List<T>>)` * 失敗: `abstract fun onFailure(e:NowDataError)` |
[表 : 13. パラメーター]

{#PaginatorAnd-observe_O__table_yj5_yyw_rqb} {#PaginatorAnd-observe_O__table_zj5_yyw_rqb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 14. 返される内容]

{#PaginatorAnd-observe_O__table_zj5_yyw_rqb}  
次のコード例は、この関数を呼び出す方法を示しています。

    suspend fun createAttachmentMetadataPaginator() {
      val paginationCallBack = object : PaginatorCallBack<NowAttachmentMetadata> {
        override fun onFailure(e: NowDataError) {
          handleError(e)
        }

        override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
          handleResponse(response)
        }

      }

      val paginator = nowServiceManager.getNowAttachmentService()?.attachmentMetadataPaginator(null, 10)
        ?.observe(paginationCallBack)
        ?: throw Exception("Response is null")
    }

## ページネーター - previous() {#ariaid-title9}

返された結果の前のページをフェッチします。
このメソッドは、前のページを取得できない場合、 `PaginationError` をスローします。
{#PaginatorAnd-previous__table_lby_sfv_kqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 15. パラメーター]

{#PaginatorAnd-previous__table_lby_sfv_kqb} {#PaginatorAnd-previous__table_mby_sfv_kqb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 16. 返される内容]

{#PaginatorAnd-previous__table_mby_sfv_kqb}  
次のコード例は、この関数を呼び出す方法を示しています。

    suspend fun createAttachmentMetadataPaginator() {
      val paginator = nowServiceManager.getNowAttachmentService()?.attachmentMetadataPaginator(null, 10)
        ?.observe(object : PaginatorCallBack<NowAttachmentMetadata> {
          override fun onFailure(e: NowDataError) {
            handleError(e)
          }

          override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
            handleResponse(response)
          }

        })
        ?: throw Exception("Response is null")

      if (paginator.hasPrevious() && !paginator.isBusy()) {
        paginator.previous()
      }
    }

## ページネーター - reset() {#ariaid-title10}

ページネーターを最初のページにリセットしますが、戻り結果の最初のページは返しません。
{#PaginatorAnd-reset__table_u1y_mgv_kqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 17. パラメーター]

{#PaginatorAnd-reset__table_u1y_mgv_kqb} {#PaginatorAnd-reset__table_v1y_mgv_kqb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 18. 返される内容]

{#PaginatorAnd-reset__table_v1y_mgv_kqb}  
次のコード例は、この関数を呼び出す方法を示しています。

    suspend fun createAttachmentMetadataPaginator() {
      val paginator = nowServiceManager.getNowAttachmentService()?.attachmentMetadataPaginator(null, 10)
        ?.observe(object : PaginatorCallBack<NowAttachmentMetadata> {
          override fun onFailure(e: NowDataError) {
            handleError(e)
          }

          override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
            handleResponse(response)
          }

        })
        ?: throw Exception("Response is null")

      paginator.reset()
    }