Skip to content

그리드 원격 페이징

원격 페이징은 그리드에서 필요에 따라 서버에서 데이터의 일부만 가져와 동적으로 데이터를 로드하고 표시할 수 있게 해주는 기능입니다. 이를 통해 모든 레코드를 한 번에 가져올 필요가 없어져 특히 큰 데이터 세트의 성능이 향상됩니다.

원격 페이징의 주요 이점

  • 성능 향상: 필요한 데이터만 로드되어 로드 시간이 단축됩니다.
  • 확장성: 큰 데이터 세트를 효율적으로 처리합니다.
  • 사용자 제어: 개발자와 사용자가 데이터 표현 방식을 유연하게 제어할 수 있습니다.

원격 페이징 작동 방식

원격 페이징은 데이터를 여러 “페이지”로 나누어 원격 서버에서 개별적으로 요청합니다. 이를 통해 한 번에 필요한 데이터 슬라이스만 로드됩니다. 도구의 기본 제공 속성을 사용하여 그리드 및 트리 그리드 구성 요소 모두에 대해 구성할 수 있습니다.

사용자는 Configurator를 사용하여 원격 페이징이 작동하는 데 필요한 모든 것을 설정합니다. 무엇이 필요한가요?

  • pageIndex - 데이터를 가져올 페이지의 인덱스입니다. 이 매개변수를 제공하지 않으면 페이지 인덱스의 기본값은 0으로, 데이터의 첫 번째 페이지를 가져옵니다.
  • pageSize - 페이지당 가져올 최대 레코드 수입니다. 이 매개변수를 제공하지 않으면 모든 레코드가 가져워지며, 전체 페이지 수는 1입니다.
  • totalRecords - 서버에서 사용 가능한 전체 레코드 수를 반환합니다. 이 수는 Paginator가 전체 페이지 수를 계산하기 위해 필요합니다.

사용자 흐름:

Configurator 사용자 흐름

사용자 구성

원격 페이징은 API가 데이터와 전체 레코드 수를 처리하는 방식에 따라 두 가지 접근 방식으로 구현할 수 있습니다.

  1. 데이터 및 전체 레코드 수에 대한 통합 엔드포인트 사용
    이 경우 API는 단일 응답에서 페이징된 데이터와 전체 레코드 수를 모두 반환합니다.

  2. 데이터 및 전체 레코드 수에 대한 별도 엔드포인트 사용
    이 설정에서는 두 개의 API 호출이 만들어집니다. 하나는 페이징된 데이터를 검색하기 위한 것이고 다른 하나는 전체 레코드 수를 가져오기 위한 것입니다.

단일 엔드포인트

지원되는 데이터 구조의 예입니다:

{
  "items": [
    {
      "categoryId": 0,
      "description": "string",
      "name": "string"
    }
  ],
  "totalRecordsCount": 0,
  "pageSize": 0,
  "pageNumber": 0,
  "totalPages": 0
}

단계:

  1. 그리드를 Items 컬렉션과 전체 레코드 수 필드가 있는 개체를 반환하는 엔드포인트에 연결합니다. 항목 컬렉션과 전체 레코드 수를 제공하는 개체입니다.
  2. 원격 페이징 기능을 추가하고 구성 대화 상자를 로드하기 위해 원격 페이징 모드를 선택합니다.
  3. 페이징 구성 대화 상자를 통해 전체 레코드 수에 해당하는 필드 속성을 선택합니다. 위의 예에서는 “totalRecordsCount”가 됩니다.
  4. 페이징 구성 대화 상자를 통해 페이지 인덱스에 사용할 쿼리 매개변수와 페이지 크기에 사용할 쿼리 매개변수를 지정합니다.
  5. 저장을 클릭합니다

결과:

  • 페이지 인덱스와 페이지 크기 값을 저장하기 위한 숫자 유형의 두 변수가 생성됩니다.
  • 그리드 데이터 컨텍스트를 저장하기 위한 세 번째 변수가 생성됩니다. 개체 유형으로, 데이터 요청에서 초기화됩니다. 요청 쿼리 매개변수가 페이지 인덱스 및 페이지 크기 변수에 바인드됩니다.
  • 그리드가 세 번째 변수 데이터 컨텍스트 결과 -> result.items 컬렉션에 바인드됩니다.
  • 전체 레코드 수가 result.totalRecordsCount 필드에 바인드됩니다.
  • PerPageChanged 및 PageChange에 대한 두 개의 상호작용이 자동으로 생성됩니다.
    • PerPageChange는 igx-paginator에서 제공하는 이벤트 컨텍스트에서 오는 페이지 크기로 소스(값)가 설정됩니다. 대상 변수는 페이지 크기입니다.
    • PageChange는 igx-paginator에서 제공하는 이벤트 컨텍스트에서 오는 페이지 인덱스(현재 페이지)로 소스(값)가 설정됩니다. 대상 변수는 페이지 인덱스입니다.

동작: 미리보기에서 초기 로드는 하나의 요청만 수행합니다. 페이지 변경 또는 페이지당 값 변경 시 새로운 페이지 및 크기 값에 따라 데이터를 가져오기 위해 새로운 요청이 만들어집니다.

두 개의 서로 다른 엔드포인트

단계:

  1. 그리드의 데이터 속성을 페이지 및 크기 쿼리 매개변수가 필요한 엔드포인트에 바인드합니다.
  2. 원격 페이징 기능을 추가하고 구성 대화 상자를 로드하기 위해 원격 페이징 모드를 선택합니다.
  3. totalRecordsCount를 서로 다른 엔드포인트(그리드 데이터 속성과 다름)에 연결하여 전체 레코드 수만 반환합니다.
  4. 페이징 구성 대화 상자를 통해 페이지 인덱스에 사용할 쿼리 매개변수와 페이지 크기에 사용할 쿼리 매개변수를 지정합니다.
  5. 저장을 클릭합니다

결과:

  • 페이지 인덱스와 페이지 크기 값을 저장하기 위한 숫자 유형의 두 변수가 생성됩니다.
  • 그리드 데이터 소스는 두 개의 새로 생성된 변수에 바인드된 쿼리 매개변수를 가집니다.
  • 전체 레코드 수를 저장하기 위한 세 번째 변수가 생성됩니다. 개체 유형으로, 데이터 요청에서 초기화됩니다. (참고: 현재 AB는 원시 결과 유형을 지원하지 않습니다)
  • PerPageChanged 및 PageChange에 대한 두 개의 상호작용이 자동으로 생성됩니다.
    • PerPageChange는 igx-paginator에서 제공하는 이벤트 컨텍스트에서 오는 페이지 크기로 소스(값)가 설정됩니다. 대상 변수는 페이지 크기입니다.
    • PageChange는 igx-paginator에서 제공하는 이벤트 컨텍스트에서 오는 페이지 인덱스(현재 페이지)로 소스(값)가 설정됩니다. 대상 변수는 페이지 인덱스입니다.

동작:

  • 미리보기로 이동하면 초기 로드가 두 개의 요청을 수행합니다. 하나는 그리드 슬라이스 데이터용이고 다른 하나는 전체 레코드 수용입니다. 그 후 페이지 변경 또는 페이지당 변경 시 그리드 슬라이스 데이터에 대해서만 하나의 요청이 만들어집니다.

알려진 제한 사항

사용자가 configurator로 원격 페이징을 설정하고 다시 실행하면 API 엔드포인트에서 초기화된 중복 변수가 계속 존재합니다.

추가 리소스