데이터 소스 Java 라이브러리 설치

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

목차

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

요구사항

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

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

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

종속 항목

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

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

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

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

제공된 라이브러리 사용

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

Maven을 사용하는 경우 다음과 같은 설정으로 시각화 라이브러리의 종속 항목을 설정하세요.

  • 그룹 ID: com.google.visualization
  • 아티팩트 ID: 시각화-datasource
  • 버전 번호: 프로젝트 페이지에 나열된 최신 버전 번호를 사용합니다.

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

예 실행

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으로 보내주세요.