페이지네이션

Altium 365 API는 Relay connection specification을 따르는 커서 기반 페이지네이션을 사용합니다. 컬렉션 쿼리는 노드 목록, 페이지네이션 메타데이터, 그리고 결과를 앞뒤로 탐색하기 위한 커서를 포함하는 connection 타입을 반환합니다.

Connection 구조

페이지네이션된 응답은 다음과 같은 형태를 가집니다:

query {
  someCollection {
    nodes {        # the items on this page
      ...
    }
    pageInfo {     # pagination metadata
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }
    totalCount     # total number of items (all pages)
  }
}

페이지 가져오기

컬렉션을 앞으로 페이지 이동하며 조회하려면 first 및 after 인수를 사용합니다:

query {
  desProjects(first: 20, after: "{cursor}") {
    nodes {
      id
      name
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

• first – 반환할 항목 수(페이지 크기)

• after – 이전 페이지의 끝을 나타내는 커서이며, 첫 번째 요청에서는 생략합니다

endCursor의 pageInfo은 다음 페이지의 after 값이 됩니다. hasNextPage이 false가 될 때까지 계속 진행합니다.

뒤로 페이지 이동하려면 last 및 before을 startCursor와 함께 사용합니다.

첫 번째 요청

첫 페이지의 경우 after 인수를 생략합니다:

query {
  desProjects(first: 20) {
    nodes {
      id
      name
      updatedAt
    }
    pageInfo {
      hasNextPage
      endCursor
    }
    totalCount
  }
}

페이지네이션을 시작하기 전에 예상 페이지 수를 파악하려면 totalCount를 사용합니다.

항목을 가져오지 않고 개수만 확인하기

전체 개수만 필요하다면 nodes는 완전히 생략할 수 있습니다:

query {
  desProjects {
    totalCount
  }
}