가장 일반적으로 사용되는 클래스에 관한 소개는 키 클래스를 참고하세요.
데이터 소스 자바 라이브러리 패키지에 관한 소개는 아래 링크를 따라가세요.
키 클래스
키 클래스는 DataSourceServlet, DataTable, Query, DataSourceHelper입니다.
가장 간단한 라이브러리 구현은 DataSourceServlet에서 상속받고 자체 generateDataTable() 구현을 작성한 후 서블릿 내에서 구현을 실행하는 것입니다. 이 구현 유형은 시작하기 섹션에 설명되어 있습니다.
DataTable 클래스는 데이터 테이블의 열, 열 유형, 라벨, ID, 커스텀 속성을 정의합니다.
Query 클래스는 데이터 쿼리의 기본 클래스로 시각화에서 생성된 쿼리를 처리합니다.
더 복잡한 사용 사례의 경우 도우미 클래스 DataSourceHelper가 도우미 함수 세트를 제공합니다. 이러한 유형의 구현은 기능 정의 및 이벤트 흐름에 설명되어 있습니다.
datasource
최상위 패키지로, 대부분의 데이터 소스 개발자가 상호작용하는 API 클래스를 포함합니다.
또한 이 최상위 수준은 Capabilities이며, 이는 데이터 소스의 쿼리 기능을 정의하는 데 사용됩니다.
base
이 패키지에는 패키지 간의 순환 종속 항목을 방지하기 위해 2개 이상의 패키지에서 사용되는 모든 클래스가 포함되어 있습니다. 가장 주목할 만한 항목은 미국 영어의 기본 언어로 된 오류 메시지입니다. 구현을 국제화하려면 이러한 메시지를 번역해야 합니다.
datatable
이 패키지에는 데이터 테이블 구조 (열, 행, 셀)와 기능 (삽입, 추가)을 처리하는 클래스가 포함되어 있습니다.
이 패키지에는 라이브러리에서 지원되는 값 및 값 유형을 처리하는 value 패키지도 포함되어 있습니다. 사용 가능한 값 유형은 ValueType 열거형에 정의되며 불리언, 날짜, 시간, 날짜 및 시간, null, 숫자, 텍스트가 포함됩니다.
query
이 패키지에는 쿼리를 처리하는 클래스가 포함되어 있으며 기본 클래스는 Query입니다.
이 패키지에는 다음 패키지도 포함됩니다.
parser- 쿼리 파싱을 처리하는 클래스입니다.
engine- 쿼리 실행을 처리하는 클래스입니다.scalarfunction- 쿼리에 사용되는 스칼라 함수를 처리하는 클래스
render
이 패키지에는 응답의 형식을 지정하는 클래스가 포함되어 있습니다. 예를 들면 다음과 같습니다.
CsvRenderer는 데이터 테이블을 CSV로 렌더링합니다.HtmlRenderer는 데이터 테이블을 HTML로 렌더링합니다.JsonRenderer는 데이터 테이블을 JSON으로 렌더링합니다.EscapeUtil는 문자열을 이스케이프하는 유틸리티를 제공합니다.
util
이 패키지는 두 가지 도우미 함수 집합을 제공합니다.
CsvDataSourceHelper및CsvDataSourceException는 CSV 파일을 데이터 저장소로 사용하는 도우미 함수를 제공하지만 데이터 소스의 전체 구현을 제공하지는 않습니다. 구현 예는 외부 데이터 저장소 사용을 참조하세요.SqlDataSourceHelper및SqlDatabaseDescription는 mySQL 데이터베이스를 데이터 저장소로 사용하는 도우미 함수를 제공하지만 데이터 소스의 전체 구현을 제공하지는 않습니다. 구현 예는examples패키지의SqlDataSourceServlet를 참고하세요.