셰이드로 코딩: Google Data API와 Eclipse 사용

Jeff Fisher, Google 데이터 API팀
2008년 4월

신규 Google Data API 자바 클라이언트 Eclipse 플러그인 : 몇 초 만에 프로젝트 만들기

이 자료 외에도 Eclipse 플러그인을 사용하면 Google 데이터 종속 항목을 설정하는 데 따른 오버헤드를 최소화할 수 있습니다. 상용구 코드를 생성하여 관심 있는 API와 상호작용합니다. 이를 통해 Google 데이터 API로 쉽게 개발을 시작할 수 있습니다.


소개

Eclipse는 매우 편리한 무료 도구입니다. 여러 자바 프로그래머의 심장에 특별한 위치를 갖는 IDE입니다. 따라서 자바 클라이언트 라이브러리와 함께 사용하여 Google Data API 중 하나와 작동하는 킬러 자바 애플리케이션을 만드는 것도 당연한 일입니다.

Eclipse 설정

아직 Eclipse가 설치되지 않은 경우 기회를 놓치게 됩니다. Eclipse는 수정을 제안하고 누락된 가져오기를 찾고 자동 완성 메서드를 제공하는 기능으로 인해 자바 개발을 훨씬 더 쉽게 할 수 있습니다. Eclipse.org 다운로드 페이지로 이동하여 운영체제에 맞는 설치 프로그램을 다운로드합니다. Eclipse를 실행하려면 Eclipse 다운로드 페이지에서 연결되는 JRE가 설치되어 있어야 합니다. Eclipse를 설치했으면 작업공간을 만들어야 합니다. 이 예에서는 /usr/local/eclipse/workspace를 사용합니다.

필수 라이브러리 설치

Eclipse는 바로 사용할 수 있는 많은 자바 기능을 제공하므로 쉽게 사용할 수 있습니다. 먼저 프로젝트 다운로드 페이지에서 자바 클라이언트 라이브러리의 최신 버전을 가져옵니다. 샘플 다운로드와 소스 코드 다운로드, 이렇게 두 가지가 있습니다. 자체 프로그램을 만드는 데 필요한 자바 클라이언트 라이브러리의 컴파일된 JAR 파일이 포함되어 있으므로 샘플 zip을 다운로드합니다. 클라이언트 라이브러리 자체의 작동 방식이 궁금하다면 소스 ZIP을 다운로드하여 훑어볼 수 있습니다. 이 내용은 이 문서에서 다루지 않습니다. 샘플 ZIP 파일을 다운로드한 후 파일을 찾을 수 있는 편리한 디렉터리에 압축을 풉니다. 이 예에서는 /usr/local/eclipse를 사용합니다. 즉, 이제 /usr/local/eclipse/gdata/java/lib에서 프로젝트의 JAR 파일에 액세스할 수 있습니다.

이제 클라이언트 라이브러리를 설치했으므로 다음 단계는 외부 빌드 종속 항목을 다운로드하여 프로젝트 빌드 경로에 포함할 수 있도록 하는 것입니다. INSTALL-samples.txt 파일에는 필요한 jar 목록과 이를 다운로드할 위치가 포함되어 있습니다. 현재 목록은 다음과 같습니다.

파일 이름 위치
mail.jar Sun의 JavaMail API
activate.jar Sun의 JavaBeans 활성화 프레임워크
서블릿-API.jar Apache Tomcat

이 예에서는 이러한 JAR 파일이 /usr/local/eclipse/gdata/third_party에 다운로드되고 복사됩니다.

휴, 다행이다! 이제 Google 데이터 API 중 하나를 사용하는 자바 애플리케이션 개발을 시작하는 데 필요한 모든 준비가 끝났습니다. 계속 읽어보세요.

새 애플리케이션 만들기

첫 번째 단계는 Eclipse를 열고 파일 메뉴에서 '새로 만들기 > 자바 프로젝트'를 선택하는 것입니다.

Eclipse 새 프로젝트 창

이제 Next(다음)를 클릭하고 Libraries(라이브러리) 탭을 선택합니다. '외부 JAR 추가'를 클릭하여 다운로드한 모든 종속 JAR 파일을 추가합니다.

종속 항목 JAR 추가

자바 클라이언트 라이브러리의 JAR 파일도 추가해야 합니다. 클라이언트 라이브러리의 압축을 푼 java/lib 하위 디렉터리에 있습니다. gdata-client, gdata-client-meta, gdata-core, gdata-media와 같은 JAR 파일을 항상 포함해야 합니다.

GData JAR 추가

이제 사용할 API를 선택하세요. 이 예에서는 Google Documents List API를 사용합니다. 이를 위해서는 적절한 JAR 파일(gdata-docs 및 gdata-docs-meta)을 추가해야 합니다.

DocList JAR 추가

마지막으로 'Finish'(완료)를 클릭하여 새 프로젝트를 만듭니다.

새로 생성된 프로젝트

간단한 테스트 애플리케이션을 만들려면 File 메뉴에서 'New > Class'를 선택하여 main 메서드로 새 클래스를 만듭니다.

수업 만들기

이제 Documents List API용 개발자 가이드의 코드 몇 개를 붙여넣어 보겠습니다.

오류가 있는 샘플 코드

적절한 import 문을 추가할 때까지 많은 오류가 발생합니다. Eclipse를 사용하면 이 작업을 쉽게 수행할 수 있습니다. 왼쪽에 있는 오류 마커를 클릭하기만 하면 가져오기를 추가할 수 있는 유용한 메뉴가 표시됩니다.

빠른 수정 메뉴

가져오기를 지우고 나면 코드에서 발생할 수 있는 예외도 처리해야 합니다. 이 예시에서는 전체 샘플 코드를 매우 기본적인 예외 핸들러로 둘러싸도록 선택합니다.

작동하는 샘플 코드

이제 사용자 이름과 비밀번호를 사용자가 만든 유효한 테스트 계정으로 대체한다고 가정하고, 실행 메뉴에서 '실행'을 선택하면 해당 테스트 계정이 소유한 문서의 목록을 볼 수 있습니다.

프로그램 출력

반가운 소식을 전해드립니다.

마무리

이제 Eclipse의 작업 인스턴스와 필요한 모든 JAR 파일이 준비되었으므로 Google 데이터 API 중 하나와 함께 사용할 수 있는 멋진 자바 애플리케이션을 빌드할 준비가 되었습니다.

다음 단계는 무엇인가요? 몇 가지 유용한 링크가 있습니다.

자바는 미국 및 기타 국가에서 사용되는 Sun Microsystems, Inc. 의 상표입니다.