가장 일반적으로 사용되는 클래스에 관한 소개는 키 클래스를 참고하세요.
데이터 소스 Java 라이브러리 패키지에 대한 소개는 아래 링크를 참조하세요.
주요 클래스
키 클래스는 DataSourceServlet, DataTable, Query, DataSourceHelper입니다.
가장 간단한 라이브러리 구현에는 DataSourceServlet에서 상속하여 자체 generateDataTable() 구현을 작성한 후 서블릿 내에서 구현을 실행하는 것입니다. 이러한 유형의 구현은 시작하기 섹션에 설명되어 있습니다.
DataTable 클래스는 데이터 테이블의 열, 열 유형, 라벨, ID, 커스텀 속성을 정의합니다.
Query 클래스는 데이터 쿼리의 기본 클래스이며 시각화 생성 쿼리를 처리합니다.
더 복잡한 사용 사례의 경우 도우미 클래스 DataSourceHelper에서 일련의 도우미 함수를 제공합니다. 이러한 유형의 구현은 기능 및 이벤트 흐름 정의에 설명되어 있습니다.
datasource
이 패키지는 최상위 패키지로, 대부분의 데이터 소스 개발자가 상호작용하는 API 클래스를 포함합니다.
또한 이 최상위 수준에는 데이터 소스의 쿼리 capabilities을 정의하는 데 사용되는 Capabilities가 있습니다.
base
이 패키지에는 패키지 간의 순환 종속 항목을 방지하기 위해 두 개 이상의 패키지에서 사용하는 모든 클래스가 포함되어 있습니다. 가장 중요한 항목은 기본 언어(미국 영어)로 된 오류 메시지입니다. 구현을 국제화하려면 이러한 메시지를 번역해야 합니다.
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를 참고하세요.