데이터 소스 자바 라이브러리 설치

이 페이지에서는 Google 시각화 자바 라이브러리를 사용하거나 수정하는 방법과 프로젝트의 오픈소스 코드에 기여하는 방법을 설명합니다.

목차

  1. 요구사항
  2. 종속 항목
  3. 제공된 대로 라이브러리 사용하기
  4. 예시 실행하기
  5. 라이브러리 수정
  6. 오픈소스 프로젝트 참여

요건

Google 시각화 자바 라이브러리를 사용하려면 다음 구성요소가 있어야 합니다.

  • 서블릿 컨테이너 및 Servlet API 버전 2.4 이상 가장 일반적으로 사용되는 서블릿 컨테이너 중 하나는 Servlet API가 포함된 Apache Tomcat입니다. 버전 5.5용 바이너리를 다운로드하려면 http://tomcat.apache.org/download-55.fp를 참조하세요. Core 모듈만 설치하면 됩니다. 또한 Tomcat은 시작하기, 외부 데이터 저장소 사용, 기능 및 이벤트 흐름 정의 튜토리얼 섹션을 완료해야 합니다.
  • 자바 개발 키트 버전 6.0 이상

    참고: JDK 버전 5.0을 사용할 수도 있습니다. 하지만 인터페이스 메서드를 재정의하는 라이브러리의 모든 메서드에서 @Override를 삭제해야 합니다. 이는 JDK 버전 6.0의 @Override 주석 동작이 변경되었기 때문입니다.

종속 항목

데이터 소스 자바 라이브러리에는 다음과 같은 종속 항목이 있습니다. 라이브러리는 나열된 버전으로 테스트되었습니다. 다른 버전은 허용될 수 있지만 테스트되지 않았습니다.

소스 또는 다운로드에 포함됨:

소스 또는 다운로드에 포함되지 않음:

  • SqlDataSourceHelper 데이터베이스를 mySQL 데이터베이스와 함께 사용하려면 런타임 환경에도 mysql.jar가 필요합니다. 자세한 내용과 다운로드 가능한 버전은 http://www.mysql.com/products/connector/j/를 참조하세요.

제공된 대로 라이브러리 사용하기

이 섹션에서는 시각화 자바 라이브러리를 수정할 필요가 없는 경우 해당 라이브러리를 사용하는 방법을 설명합니다. 이 프로세스는 빌드 시스템에 따라 다릅니다.

Maven을 사용하는 경우 다음 설정을 사용하여 시각화 라이브러리의 종속 항목을 설정합니다.

  • 그룹 ID: com.google.visualization
  • 아티팩트 ID: 시각화 데이터 소스
  • 버전 번호: 프로젝트 페이지에 표시된 최신 버전 번호를 사용하세요.

다른 빌드 시스템을 사용하는 경우:

예시 실행하기

JAR 예 파일은 다운로드 가능한 ZIP 파일의 라이브러리 JAR과 함께 포함됩니다. 예시 실행에 관한 안내는 시작하기 페이지를 참고하세요.

라이브러리 수정

라이브러리 코드를 수정하려면 오픈소스 호스팅 사이트에서 소스를 다운로드하여 빌드해야 합니다. 이 작업을 진행하기 전에 프로젝트 페이지의 '코드 라이선스' 섹션에서 연결된 라이선스 정보를 읽고 사용 사례가 허용되는지 확인하세요.

라이브러리를 다운로드하고 빌드하는 단계는 다음과 같습니다.

  1. 오픈소스 프로젝트 페이지의 소스 > 결제 탭에 설명된 대로 SVN을 사용하여 소스 코드를 다운로드합니다.
  2. 코드를 빌드합니다. Maven에서 빌드하는 경우 소스와 함께 제공된 pom.xml 파일을 사용합니다. Apache Ant로 빌드하는 경우 다음 안내를 따르세요 (코드는 Ant 버전 1.7.0으로 테스트되었습니다. Ant의 이전 버전이 있는 경우 업그레이드해야 할 수 있음).

Ant 빌드 안내

1. 빌드 속성을 수정합니다.

  1. 선택한 설치 디렉터리의 build-src 하위 디렉터리로 이동합니다.
  2. 텍스트 편집기를 사용하여 build.properties 파일을 열고 다음과 같이 변경합니다.
    • servlet-api.jar 파일을 가리키도록 servlet-api.jar 속성을 수정합니다. 예를 들어 tomcat_home 디렉터리의 c: 드라이브에 Tomcat을 설치한 경우 다음과 같이 servlet-api.jar 속성을 지정합니다.
      servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

      참고: Windows를 사용하는 경우에도 파일 경로에 백슬래시 대신 슬래시를 사용하세요.

    • 위에 설명된 종속 항목의 자체 사본을 사용하려면 동일한 build.properties 파일의 경로를 수정합니다.

2. 라이브러리를 빌드합니다.

파일에서 build-src 하위 디렉터리를 탐색하고 다음 중 하나를 입력합니다.

  • ant datasource - 데이터 소스 라이브러리 빌드
  • ant example - 예시 빌드
  • ant - 데이터 소스와 예시를 모두 빌드합니다.
  • ant test - 데이터 소스 라이브러리 테스트를 빌드하고 실행합니다. 라이브러리를 수정할 때 매우 유용합니다.

오픈소스 프로젝트 참여

오픈소스 프로젝트에 변경사항을 제공하려면 프로젝트에 대한 제출 권한을 얻어야 합니다. 권한 및 변경사항 제출 방법에 대한 안내를 요청하는 이메일을 google-visualization-api@googlegroups.com으로 보내주세요.