라이브러리 패키지 및 키 클래스

가장 일반적으로 사용되는 클래스에 관한 소개는 키 클래스를 참고하세요.

데이터 소스 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

이 패키지는 두 가지 도우미 함수 집합을 제공합니다.

  • CsvDataSourceHelperCsvDataSourceException는 CSV 파일을 데이터 저장소로 사용하기 위한 도우미 함수를 제공하지만 데이터 소스의 완전한 구현을 제공하지는 않습니다. 구현 예는 외부 데이터 저장소 사용을 참고하세요.
  • SqlDataSourceHelperSqlDatabaseDescription는 MySQL 데이터베이스를 데이터 저장소로 사용하기 위한 도우미 함수를 제공하지만 데이터 소스의 완전한 구현은 제공하지 않습니다. 구현 예는 examples 패키지의 SqlDataSourceServlet를 참고하세요.