---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Classe do paginador - Android

# Classe do paginador - Android {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

A classe Paginator fornece funções para paginação por meio dos resultados de retorno passados por uma chamada de endpoint REST, como aqueles retornados pela classe NowTableService.

Você deve primeiro chamar a função [NowTableService - paginador (de tableName: cadeia de caracteres, configuração: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/7OkD2nFbZV5lWhWHvsIMxA#NTblServ-paginator_S_O "Cria um paginador que permite a iteração por meio de páginas de registros.") ou [NowTableService - paginador\<Model: Decodable\> (de tableName: cadeia de caracteres, caminho: cadeia de caracteres = Constants.resultPath, codificador: codificador = .default, configuração: FetchConfiguration? = nulo)](https://servicenow-prod.fluidtopics.net/7OkD2nFbZV5lWhWHvsIMxA#NTblServ-paginator_S_S_S_O "Cria um paginador que permite a iteração de páginas de modelos decodificados que lidam com o aninhamento.") para recuperar resultados de retorno de paginação.

## Paginador - first() {#ariaid-title2}

Busca a primeira página dos resultados de retorno.
O método emitirá um `PaginationError` se não puder buscar a primeira página.
{#PaginatorAnd-first__table_fpc_bgv_kqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 2. Retorna]

{#PaginatorAnd-first__table_gpc_bgv_kqb}  
O exemplo de código a seguir mostra como chamar essa função.

    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()
    }

## Paginador - hasNext() {#ariaid-title3}

Verifica se há uma próxima página nos resultados de retorno.
{#PaginatorAnd-hasNext__table_fxz_rww_rqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 3. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se há uma próxima página nos resultados de retorno. Valores possíveis: * verdadeiro: próxima página disponível. * falso: não há próxima página disponível. |
[Tabela 4. Retorna]

{#PaginatorAnd-hasNext__table_gxz_rww_rqb}  
O exemplo de código a seguir mostra como chamar essa função.

    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()
      }
    }

## Paginador - hasPrevious() {#ariaid-title4}

Verifica se há em uma página anterior nos resultados de retorno.
{#PaginatorAnd-hasPrevious__table_qy4_dxw_rqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 5. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se há uma página anterior nos resultados de retorno. Valores possíveis: * verdadeiro: página anterior disponível. * falso: nenhuma página anterior disponível. |
[Tabela 6. Retorna]

{#PaginatorAnd-hasPrevious__table_ry4_dxw_rqb}  
O exemplo de código a seguir mostra como chamar essa função.

    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()
      }
    }

## Paginador - isBusy() {#ariaid-title5}

Verifica se o Paginador está ocupado buscando dados.
{#PaginatorAnd-isBusy__table_w3d_cyw_rqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 7. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum(a) | Sinalizador que indica se o Paginador está ocupado buscando dados. Valores possíveis: * verdadeiro: ocupado buscando dados. * falso: não está ocupado. |
[Tabela 8. Retorna]

{#PaginatorAnd-isBusy__table_x3d_cyw_rqb}  
O exemplo de código a seguir mostra como chamar esta função.

    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()
      }
    }

## Paginador - last() {#ariaid-title6}

Busca a última página dos resultados retornados.
O método emitirá um `PaginationError` se não puder buscar a última página.
{#PaginatorAnd-last__table_ipy_hgv_kqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 9. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 10. Retorna]

{#PaginatorAnd-last__table_jpy_hgv_kqb}  
O exemplo de código a seguir mostra como chamar essa função.

    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()
      }
    }

## Paginador - next() {#ariaid-title7}

Busca a próxima página dos resultados de retorno.
O método emitirá um `PaginationError` se não houver mais páginas para buscar.
{#PaginatorAnd-next__table_kj5_5cv_kqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 11. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 12. Retorna]

{#PaginatorAnd-next__table_lj5_5cv_kqb}  
O exemplo de código a seguir mostra como chamar essa função.

    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()
      }
    }

## Paginador - observe(callback: PaginatorCallBack\<T\> ) {#ariaid-title8}

Define os retornos de chamada do objeto Paginator. Você deve chamar este método antes de chamar qualquer outra função do Paginador.
{#PaginatorAnd-observe_O__table_yj5_yyw_rqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| retorno de chamada | PaginatorCallBack | Retornos de chamada a serem chamados com base no sucesso ou na falha da criação do Paginador. * Sucesso: `resumo fun onSuccess(resposta: Resposta`\<List\<T\> \>) * Falha: `resumo fun onFailure (e: NowDataError)` |
[Tabela 13. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 14. Retorna]

{#PaginatorAnd-observe_O__table_zj5_yyw_rqb}  
O exemplo de código a seguir mostra como chamar essa função.

    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")
    }

## Paginador - anterior() {#ariaid-title9}

Busca a página anterior dos resultados retornados.
O método emitirá um `PaginationError` se não puder buscar a página anterior.
{#PaginatorAnd-previous__table_lby_sfv_kqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 15. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 16. Retorna]

{#PaginatorAnd-previous__table_mby_sfv_kqb}  
O exemplo de código a seguir mostra como chamar esta função.

    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()
      }
    }

## Paginador - redefinir() {#ariaid-title10}

Redefine o Paginador de volta para a primeira página, mas não retorna a primeira página dos resultados de retorno.
{#PaginatorAnd-reset__table_u1y_mgv_kqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 17. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 18. Retorna]

{#PaginatorAnd-reset__table_v1y_mgv_kqb}  
O exemplo de código a seguir mostra como chamar esta função.

    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()
    }