그리드 원격 페이징
원격 페이징은 그리드에서 필요에 따라 서버에서 데이터의 일부만 가져와 동적으로 데이터를 로드하고 표시할 수 있게 해주는 기능입니다. 이를 통해 모든 레코드를 한 번에 가져올 필요가 없어져 특히 큰 데이터 세트의 성능이 향상됩니다.
원격 페이징의 주요 이점
- 성능 향상: 필요한 데이터만 로드되어 로드 시간이 단축됩니다.
- 확장성: 큰 데이터 세트를 효율적으로 처리합니다.
- 사용자 제어: 개발자와 사용자가 데이터 표현 방식을 유연하게 제어할 수 있습니다.
원격 페이징 작동 방식
원격 페이징은 데이터를 여러 “페이지”로 나누어 원격 서버에서 개별적으로 요청합니다. 이를 통해 한 번에 필요한 데이터 슬라이스만 로드됩니다. 도구의 기본 제공 속성을 사용하여 그리드 및 트리 그리드 구성 요소 모두에 대해 구성할 수 있습니다.
사용자는 Configurator를 사용하여 원격 페이징이 작동하는 데 필요한 모든 것을 설정합니다. 무엇이 필요한가요?
pageIndex- 데이터를 가져올 페이지의 인덱스입니다. 이 매개변수를 제공하지 않으면 페이지 인덱스의 기본값은 0으로, 데이터의 첫 번째 페이지를 가져옵니다.pageSize- 페이지당 가져올 최대 레코드 수입니다. 이 매개변수를 제공하지 않으면 모든 레코드가 가져워지며, 전체 페이지 수는 1입니다.totalRecords- 서버에서 사용 가능한 전체 레코드 수를 반환합니다. 이 수는 Paginator가 전체 페이지 수를 계산하기 위해 필요합니다.
사용자 흐름:
Configurator 사용자 흐름
사용자 구성
원격 페이징은 API가 데이터와 전체 레코드 수를 처리하는 방식에 따라 두 가지 접근 방식으로 구현할 수 있습니다.
-
데이터 및 전체 레코드 수에 대한 통합 엔드포인트 사용
이 경우 API는 단일 응답에서 페이징된 데이터와 전체 레코드 수를 모두 반환합니다. -
데이터 및 전체 레코드 수에 대한 별도 엔드포인트 사용
이 설정에서는 두 개의 API 호출이 만들어집니다. 하나는 페이징된 데이터를 검색하기 위한 것이고 다른 하나는 전체 레코드 수를 가져오기 위한 것입니다.
단일 엔드포인트
지원되는 데이터 구조의 예입니다:
{
"items": [
{
"categoryId": 0,
"description": "string",
"name": "string"
}
],
"totalRecordsCount": 0,
"pageSize": 0,
"pageNumber": 0,
"totalPages": 0
}
단계:
- 그리드를 Items 컬렉션과 전체 레코드 수 필드가 있는 개체를 반환하는 엔드포인트에 연결합니다. 항목 컬렉션과 전체 레코드 수를 제공하는 개체입니다.
- 원격 페이징 기능을 추가하고 구성 대화 상자를 로드하기 위해 원격 페이징 모드를 선택합니다.
- 페이징 구성 대화 상자를 통해 전체 레코드 수에 해당하는 필드 속성을 선택합니다. 위의 예에서는 “totalRecordsCount”가 됩니다.
- 페이징 구성 대화 상자를 통해 페이지 인덱스에 사용할 쿼리 매개변수와 페이지 크기에 사용할 쿼리 매개변수를 지정합니다.
- 저장을 클릭합니다
결과:
- 페이지 인덱스와 페이지 크기 값을 저장하기 위한 숫자 유형의 두 변수가 생성됩니다.
- 그리드 데이터 컨텍스트를 저장하기 위한 세 번째 변수가 생성됩니다. 개체 유형으로, 데이터 요청에서 초기화됩니다. 요청 쿼리 매개변수가 페이지 인덱스 및 페이지 크기 변수에 바인드됩니다.
- 그리드가 세 번째 변수 데이터 컨텍스트 결과 -> result.items 컬렉션에 바인드됩니다.
- 전체 레코드 수가 result.totalRecordsCount 필드에 바인드됩니다.
- PerPageChanged 및 PageChange에 대한 두 개의 상호작용이 자동으로 생성됩니다.
- PerPageChange는 igx-paginator에서 제공하는 이벤트 컨텍스트에서 오는 페이지 크기로 소스(값)가 설정됩니다. 대상 변수는 페이지 크기입니다.
- PageChange는 igx-paginator에서 제공하는 이벤트 컨텍스트에서 오는 페이지 인덱스(현재 페이지)로 소스(값)가 설정됩니다. 대상 변수는 페이지 인덱스입니다.
동작: 미리보기에서 초기 로드는 하나의 요청만 수행합니다. 페이지 변경 또는 페이지당 값 변경 시 새로운 페이지 및 크기 값에 따라 데이터를 가져오기 위해 새로운 요청이 만들어집니다.
두 개의 서로 다른 엔드포인트
단계:
- 그리드의
데이터속성을 페이지 및 크기 쿼리 매개변수가 필요한 엔드포인트에 바인드합니다. - 원격 페이징 기능을 추가하고 구성 대화 상자를 로드하기 위해 원격 페이징 모드를 선택합니다.
- totalRecordsCount를 서로 다른 엔드포인트(그리드
데이터속성과 다름)에 연결하여 전체 레코드 수만 반환합니다. - 페이징 구성 대화 상자를 통해 페이지 인덱스에 사용할 쿼리 매개변수와 페이지 크기에 사용할 쿼리 매개변수를 지정합니다.
- 저장을 클릭합니다
결과:
- 페이지 인덱스와 페이지 크기 값을 저장하기 위한 숫자 유형의 두 변수가 생성됩니다.
- 그리드 데이터 소스는 두 개의 새로 생성된 변수에 바인드된 쿼리 매개변수를 가집니다.
- 전체 레코드 수를 저장하기 위한 세 번째 변수가 생성됩니다. 개체 유형으로, 데이터 요청에서 초기화됩니다. (참고: 현재 AB는 원시 결과 유형을 지원하지 않습니다)
- PerPageChanged 및 PageChange에 대한 두 개의 상호작용이 자동으로 생성됩니다.
- PerPageChange는 igx-paginator에서 제공하는 이벤트 컨텍스트에서 오는 페이지 크기로 소스(값)가 설정됩니다. 대상 변수는 페이지 크기입니다.
- PageChange는 igx-paginator에서 제공하는 이벤트 컨텍스트에서 오는 페이지 인덱스(현재 페이지)로 소스(값)가 설정됩니다. 대상 변수는 페이지 인덱스입니다.
동작:
- 미리보기로 이동하면 초기 로드가 두 개의 요청을 수행합니다. 하나는 그리드 슬라이스 데이터용이고 다른 하나는 전체 레코드 수용입니다. 그 후 페이지 변경 또는 페이지당 변경 시 그리드 슬라이스 데이터에 대해서만 하나의 요청이 만들어집니다.
알려진 제한 사항
사용자가 configurator로 원격 페이징을 설정하고 다시 실행하면 API 엔드포인트에서 초기화된 중복 변수가 계속 존재합니다.
