java.net과 이클립스를 이용한 오픈소스 자바 어플리케이션 개발

소개

이 튜토리얼 시리즈는 java.net에서 호스팅 되어 있는 오픈소스 자바 어플리케이션을 이클립스를 사용하여 개발하는 방법을 설명한다. 이 글은 자바에 대한 지식은 있지만 이클립스는 다뤄보지 않는 개발자들을 대상으로 한다.

문의사항 또는 피드백이 있다면 튜토리얼의 포럼을 이용하기 바란다.

이클립스에서 새로운 프로젝트를 어떻게 만드는지 볼 것이다. 이미 만들어진 프로젝트에 참여할 예정인 경우와 같이 새로운 프로젝트 생성이 불필요한 경우에도 이클립스의 주요 컨셉들을 이해하기 위해 이글을 읽어보기를 권장한다.

다음번 튜토리얼의 제목은 다음과 같다. :

• 이클립스와 CVS를 이용한 팀단위 개발(2 부)
  
• 이클립스에서 Ant와 JUnit를 함께 사용하여 빌드 및 테스팅 자동화하기

튜토리얼을 시작하기전에 이클립스와 Java.net의 몇가지 중요한 특징들을 살펴보자.

이클립스의 주요기능

이클립스는 자바개발을 위한 강력하고 풍부한 기능을 제공하는 통합개발환경(IDE)이다. 보다 자세한 정보에 대한 것은 아래의 링크(이클리스 온라인 도움말)를 통하여 확인해볼 수 있다.

• 자바 개발도구 팁
• 이클립스 플랫폼 팁

IDE를 사용해본적이 없거나 마지막으로 써 본 것이 몇 년 전이라면 이클립스를 주목해보는것이 좋을 것이다. 여러분은 이클립스의 편의성과 진보된 기능에 놀랄 것이다. 저자가 Emacs에서 이클립스로 개발툴을 전환한지 몇년이 되었는데 이전의 개발보다 높은 생산성을 보여주었다. 리팩토링 자동화 지원은 정말 멋진 기능이다.

이클립스는 Windows, Linux, Max OS X, Solaris, AIX 그리고 HP-UX에서 실행할 수 있다. 자바로 작성되었지만 SWT라고 불리는 그래픽 툴킷을 사용했다. SWT는 운영체제가 제공하는 GUI를 활용하여 매우 멋진 look & feel을 제공한다.


이클립스는 복잡한 플러그인 아키텍처 를 가지고 있는 범용적인 어플리케이션 플랫폼이며, 이클립스의 자바 IDE는 플러그인의 한 종류이다. 이클립스를 활용하여 고유의 플러그인들을 개발하거나 웹브라우저나 금전 관리 프로그램 등의 "rich client" 어플리케이션을 개발할 수 있다. 이클립스 플랫폼 플러그인 개발 가이드를 보면 보다 많은 정보를 얻을 수 있을 것이다.

이클립스는 독립적인 이클립스 재단에 의해 개발된 무료 오픈 소스 소프트웨어이다. 이 재단에는 IBM Rational, Borland, Red Hat, and SuSE 등과 같은 산업내의 주요 회사들이 참여하고 있다. 태생적으로 오픈소스인지라 오픈소스 개발에 이상적이다. 일례로 CVS 클라이언트 GUI를 내장하고 있어(2 부에서 다룬다) java.net과 같은 CVS 호스팅 사이트에서 개발하기가 용이하다.

이클립스의 문서는 훌륭하다. 웹사이트와 온라인 도움말을 보기바란다.

오픈소스와 상용를 막론하고 별도의 이클립스 플러그인을 개발하는 커뮤니티 활동도 활발하다. 아래 두 링크를 통해 훌륭한 플러그인들은 찾을 수 있을 것이다.

• Eclipse-Plugins.info
• Eclipse Plugin Central

이클립스 사용자들은 공식 이클립스 배포판과 플러그인 개발 커뮤니티로 부터 정기적으로 새로운 기능을 제공받는다.

java.net의 주요기능

java.net은 성공적인 자바 온라인 커뮤니티로 뉴스, 아티클, 포럼, 위키, 그리고 다양한 오픈소스 프로젝트를 위한 호스팅과 같은 기능을 제공해준다. 2003년 Sun Microsystems에 의해서 오픈소스 자바 개발을 지원하기 위해서 생겨났지만, java.net은 이클립스 재단과 마찬가지로 완전히 독립적인 단체이다. java.net에 있는 몇몇 커뮤니티들은 다양한 기술과 관심사들을 가지고 있다. 예를들어 Java Tools, Java Enterprise, Jini, Java Linux와 같은 것이 있다.
Javapedia와 국제 교육과 학습과 같은 몇몇 커뮤니티들은 지식을 공유하여 자바를 배우는 좋은 곳들이다. 이들 sourceforge와 같은 다른 개발 호스팅 웹사이트에서 나와 java.net로 옮겨온 커뮤니티들이다.

새로운 프로젝트를 만드는것이 쉽다 . 프로젝트는 만드는데 필용한 것은 오직 좋은 아이디어와 프로젝트 요청 폼뿐이다. 여러분은 java.net에 호스팅 되거나 어딘가 다른곳에 호스트되어있지만 java.net과 연결된 프로젝트들의 온라인 프로젝트 디렉토리 를 검색할 수 있다. 새로운 프로젝트를 시작하기 전에 기존의 프로젝트들을 확인하여 이미 존재하는 프로젝트를 또 생성하지 않도록 해야한다. 만약 여러분의 아이디어가 익숙한 기존 프로젝트의 질을 높이는 것이라면 최종물은 유사한 프로젝트가 되기도 한다. 기존 프로젝트에 참여하고자 하는 경우는 프로젝트의 웹사이트에 적혀있는 소유주에게 이야기하면 된다.

java.net은 CVS를 사용하여 소스코드에 대한 제어를 한다. 만약 여러분이 CVS를 사용해본적이 없다고 하더라고 걱정할 것은 없다. 2 부에서 여러분에게 단계별 가이드를 제공해주겠다. CVS에 들어있는 내용물들을 웹상에서 확인할 수 있고, CVS안의 코드나 문서의 연결이 수월해진다. 이 링크를 통해 확인해보라.

이슈 트래커, 공지 게시판, 토론포럼 그리고 메일링리스트 등등 java.net 이 제공하는 몇몇 유용한 기능들은 여러분이 팀의 일부로 작업할 때에 도움을 준다. 프로젝트 소유주들은 프로젝트의 멤버들과 역할에 대한 관리가 쉽고, 프로젝트의 멤버라면 CVS가 체크인 되거나 새로운 포럼을 생성되는 경우에 이메일을 통해서 프로젝트의 변경이 생길때 마다 변경사항을 확인할 수 있다. RSS 피드 또한 가능하여 여러분의 프로젝트를 다른사람들이 확인할 수 있게된다. 프로젝트의 웹페이지는 설정하기 매우 쉽다(단지 HTML만 체크하면 된다) 사이트 전체 검색과 개별 프로젝트내에서의 검색을 지원하는 좋은 검색 엔진 또한 제공된다.

---

튜토리얼 1부 - 이클립스에서 새로운 프로젝트 설정하기

이번 튜토리얼에서는 이클립스를 사용하여 새로운 자바 프로젝트는 생성하고 설정하는 방법에 대하여 다루겠다. java.net에서의 작업은 다음 튜토리얼에서 다루겠다.

선행사항

• 이클립스 3.0이나 그 이후의 버전을 다운로드한다. (본 튜토리얼 번역본은 3.1을 기준으로 한다)
  
• 자바 1.3 또는 그 이후 버전이 필요하다. 만약 적절한 자바 버전이 설치되어 있지 않다면 http://java.sun.com 에서 다운로드 하여 설치한다.
  

이클립스의 다운로드나 시작에 문제가 있다면이클립스 FAQ를 참고하길 바란다.

이클립스 시작하기

튜토리얼의 예제로 사용하기 위해 javatools-demo라는 프로젝트를 사용한다.
먼저 이클립스를 실행시키고 여러분의 작업공간(workspace)의 경로를 설정한다.
작업공간은 이클립스에서 사용할 여러분의 소스코드가 저장되는 폴더를 의미한다.


"Use this as the default..." 옵션을 선택하면 항상 같은 작업공간에서 이클립스가 실행된다. 나중에 여러 개의 작업공간 중에서 선택하여 이클립스를 실행하기를 원할 수 있으므로 지금은 이 옵션을 선택하지 않기를 권장한다.

이클립스가 시작되면 환영페이지를 볼 수 있다:

도움말 구하기

이클립스의 도움말은 언제든지 Help->Help Contents에서 볼 수 있다. 이 도움말은 eclipse.org 웹사이트와 동일한 내용이다.
(역자주 : Eclipse의 도움말은 자체적인 웹서버를 통해서 서비스되기 때문에 로딩 시에 시간일 걸릴수 있다.)

프로젝트 생성하기

환영페이지를 닫는다. Navigator패널에서 오른쪽 마우스 버튼을 클릭하고 New->Project를 선택한다.





"Java Project"를 선택하고 "Next"를 클릭한 후, 나타나는 다음과 같은 창에 여러분의 프로젝트 이름을 적는다:



"Finish"를 클릭한다. 자바 퍼스펙티(Java perspective)로 변경할 것인지 묻는 프롬프트 창이 뜨게 된다면 "Yes"를 선택한다.

퍼스펙티브(Perspectives) 이클립스는 서로 다른 유형의 작업을 위해서 다양한 퍼스펙티브를 제공한다. 사용 가능한 모든 퍼스펙티브를 보고 싶다면 Window->Open Perspective->Other...를 선택하면 된다. 지금 우리가 위치한 "Java" 퍼스펙티브는 자바 어플리케이션을 개발하는데 유용한 편집기, 뷰(views)와 메뉴 아이템들을 제공해준다. 자바 프로젝트를 생성하기 전의 "Resource" 퍼스펙티브는 윈도우 익스플로러 스타일의 파일 탐색기와 같은 기본적인 도구들을 제공한다. 빠르게 퍼스펙티브를 변경하고 싶다면 이클립스창의 오른쪽 상단의 버튼을 이용하면 된다.

프로젝트는 앞서 선택한 작업공간에 저장된 디렉토리일 뿐이다. 파일시스템에서 직접 확인해 보자.

JRE 변경

자바 퍼스펙티브의 Package Explorer 패널에 새로 만들어진 프로젝트에서 오른쪽 클릭을 하고, Properties를 선택한다. Properties 대화창의 왼쪽 패널에서 Java Build Path를 선택하면 프로젝트 클래스패스를 조작할 수 있다.

 

Libraries 탭을 통해 확인해보면, 현재는 오직 JRE 시스템 라이브러리만 등록된 것을 알 수 있을 것이다. 기본 설정의 JRE 시스템 라이브러리는 이클립스를 실행하는데 쓰이는 JRE를 의미한다. 필자의 경우는 자바 5.0 JRE가 설치되어서 사용되고 있다. 여러분이 어떤 버전의 자바를 설치했느냐에 따라 다른 JRE를 보게 될 수 있다

여러분이 다른 JRE를 쓰고자 할 수도 있다. 예를 들어 기본 설정은 자바 5.0 이지만, 여러분의 프로젝트가 보다 많은 사람들에게 쓰일 수 있게 하기 위해서 자바 1.4 혹은 1.3 버전과 호환되기를 원할 수 있다.

기본적인 JRE에 만족한다면 다음 섹션으로 넘어가도 무방하다.

먼저 여러분의 컴퓨터에 알맞은 JDK 또는 JRE가 설치되어 있어야 한다. 그렇지 않다면 http://java.sun.com 에서 다운로드하여 설치해야 한다.

"Add Library"를 클릭한다:




"Next"를 클릭하고 "Installed JREs..."를 클릭한다.



"Add"를 클릭한다.

다음 대화창에서 여러분이 사용할 JRE 나 JDK를 찾은 후 이름을 입력한다. 여러분이 새로 추가하는 JRE에 여러분이 부여하는 이름이다.

 

"OK"를 클릭하고 새로운 JRE를 선택한다.

 

"OK"를 클릭하고 "Finish"를 클릭한다. 여러분의 프로젝트는 새로운 JRE로 컴파일하게 될 것이다.

 

소스 폴더 생성하기

Properties 대화창에서 "Source" 탭을 선택한다.



이클립스의 프로젝트는 자바 소스 파일을 포함하는 하나 이상의 소스 폴더를 가질 수 있다. 최초에는 프로젝트 디렉토리 자체가 유일한 소스 폴더가 된다.

여러개의 소스 폴더를 사용하는 것은 다른 종류의 코드들을 분리하는데 좋은 방법이다. 이러한 방법을 활용하면 작업이 더 수월해지고, 나중에 다루게 되는 Ant 빌드 스크립트를 간결하게 할 수 있다.

"Add Folder"를 클릭하고 "src"라고 쓴다.



프롬프트창에서 "Yes"를 클릭한다.



"Add Folder..."를 다시 클릭하고 "Create New Folder..."를 클릭한다. 이번엔 폴더를 "test" 라고 명명한다. "OK"를 연속해서 클릭한다.

여러분은 이제 두 개의 소스 폴더를 확인할 수 있다.



"Order and Export" 탭을 클릭하면 프로젝트의 자바 코드를 컴파일할 때 사용하는 클래스패스 전체를 볼 수 있다. 아직 우리는 소스 코드를 작성하지는 않았다.

이제 클래스패스에는 JRE와 함께 두 개의 소스 폴더가 포함되어 있다.

.

클래스 저장 폴더(Output folder) 여러분이 프로젝트 디렉토리가 아닌 별도의 소스 폴더를 사용하게 되면 컴파일러는 생성된 클래스 파일을 "output folder"라고 부르는 별도의 폴더에 저장한다. 위의 대화창에서 볼 수 있듯이 클래스 저장 폴더는 프로젝트 아래에 있는 bin 디렉토리로 설정된다. 특별한 이유가 없는 경우는 이러한 설정을 변경하지 않는 것이 좋다. 기본적으로 여러분은 bin 디렉토리나 클래스 파일을 Package Navigator에서 볼 수 없게 된다. Navigator로 뷰를 전환하면 프로젝트의 모든 파일과 디렉토리를 걸러지지 않은 채로 보게된다.

외부에서 만든 JAR 파일 가져오기

여러분의 어플리케이션이 외부에서 제작한 라이브러리를 사용하는 경우에는 JAR 파일 형태로 프로젝트에 포함시키고, 프로젝트의 클래스패스에 추가할 수 있다.

예제 어플리케이션이 날짜를 처리할 필요가 있어서 잘 만들어진 Joda Time API를 사용하기로 했다고 가정해보자.

먼저 실행 파일 형태의 라이브러리를 다운로드 하고, 압축을 해제한다. 그리고, 여러분의 프로젝트에 새로운 폴더를 생성한다.





새로운 폴더 생성을 위한 창이 뜨면, 폴더를 lib 라고 이름 짓는다. 새로 만든 폴더에서 오른쪽 마우스 클릭을 하고, "Import..."를 선택한다.




대화창이 뜨면, "File System"을 선택하고 "Next"를 클릭한다. 라이브러리의 압축을 풀어 둔 디렉토리를 찾아서 JAR 파일을 선택한다.

"Browse" 버튼을 선택하고 정확하게 JAR 파일이 위치한 디렉토리를 찾아야 한다. 그렇지 않은 경우에는 JAR 파일을 포함하고 있는 디렉토리 이외에 원치 않는 폴더까지 가져올 수 있음을 유의하자.



"Finish"를 클릭한다. 정상적으로 수행했다면 다음과 같은 결과를 얻는다.



이제 JAR 파일을 프로젝트 클래스패스에 추가해보자. 프로젝트에서 오른쪽 마우스를 클릭하고 "Properties" 를 선택한다. "Java Build Path"의 "Libraries"탭으로 이동한다.



"Add JARs..."를 선택하고 새로 가져온 JAR를 선택한 뒤 "OK"를 클릭한다.

소스 코드 가져오기

Eclipse로 가져올 기존의 소스 코드가 없다면 이번 섹션은 넘어가도 무방하다.

여러분의 프로젝트에서 마우스 오른쪽 버튼을 클릭하고 "Import"를 선택하면 코드를 가져올 수 있다.
   


여러분의 코드가 ZIP이나 JAR형태의 파일이라면 "Zip file"을 선택한다. 그 외의 경우는 "File System"을 선택한다. 나머지 진행에 관한 부분은 별도의 설명이 필요없을 것이다.

클래스 생성하기

여러분이 새로운 자바 코드를 생성하기를 원한다면, "src" 소스폴더에서 마우스 오른쪽 버튼을 클릭한 후 "New->Class"를 선택한다.



클래스가 위치할 패키지의 이름을 적는다.

도메인 이름을 거꾸로 적는것이 일반적인 패키지 이름을 적는 규칙이라고 하더라도, net.java 를 프로젝트의 접두어로 사용하지 않겠다. 그 이유는 링크 시킨 위키에서 잘 설명되어 있다.

org.jtdemo라고 하겠다..

더 이상의 설명을 필요하지 않을 것이다. 자유롭게 테스트 해보자



에디터 윈도우에서 여러분이 방금 만들어 낸 클래스를 볼 수 있다.

뷰와 에디터 이클립스에서는 뷰와 에디터가 구별된다. 위에 보이는 자바 에디터와 같이 에디터는 직접 수정할 수 있는 내용(content)를 보여주는 창이다. 에디터에서 수정한 변경사항은 여러분이 저장하기 전까지는 아무런 영향을 미치지 않는다. 에디터의 타이틀바를 드래깅하여 다양한 형태로 겹치게 하거나 격자로 놓을 수 있다. 열려진 모든 에디터들의 목록을 보고 싶다면 Ctrl-E를 누르면 된다. 뷰는 내용(content)을 보다 추상화 된 형태로 보여주는 창이다. 예를들어 Package Explorer, Problems, Outline 뷰와 같은 것들이 뷰라고 할 수 있다. 뷰에서의 변경사항은 즉시 반영된다. 뷰의 타이틀 바를 드래그하여 다양한 형태로 고정시킬 수 있고, 겹치게 하거나 격자형태로 위치시킬 수 있다. 새로운 뷰를 열고 싶다면 Window->Show View->Other...를 선택하면 된다. 해당 뷰나 에디터를 최대화시키고 싶다면 타이틀바를 더블클릭하거나 Ctrl-M을 누르면 된다.

이제 여러분이 코드를 작성할 준비가 되었다.

이클립스에는 자바 개발에 필요한 유용한 기능이 있지만, 아직 여기서 그 기능들을 설명하지는 않는다. 어떤 것들이 가능한지 알아보기 위해서는 자바 개발 도구 팁과 기법과 이클립스 기본 팁과 기법을 직접 보고, 직접 조작해볼 수 있다.

preference 공유하기

대부분의 이클립스의 기능들은 preference를 통해 다양한 방식으로 설정이 가능하다. 여러분의 preferences를 다른 사람들과 공유하고자 할 수 있다. 가령, 동일한 코딩 스타일을 규칙으로 삼고 싶다고 가정하자. 또한 여러개의 작업공간을 가지고 있고 그 작업공간들에서 모두 같은 preference를 사용하고 싶다고 가정해 보자.

Preference 대화창(Window->Preferences)에서 Export 버튼을 사용하여 여러분의 preference를 내보낼 수 있다. 이렇게 하면 XML 형식으로 여러분의 Preferences를 내보게 된다. 내보내진 Preferences는 Import 버튼을 사용하여 가져올 수 있다.

다수의 프로젝트들와 Order and Export 탭

필요에 따라 여러개의 자바 프로젝트들을 생성하고, 다른 프로젝트의 내용을 서로 사용할 수도 있다. "other"라는 이름의 새로운 자바 프로젝트를 만들고, 빌드 경로를 보자. (마우스 오른쪽 클릭후, Properties, 자바 빌드 패스(Java Build Path)). "Add..." 버튼을 누르고 기존 프로젝트 항목을 체크하여 빌드할 때 사용할 수 있도록 한다.



기존 프로젝트의 빌드 패스를 보자. "Order and Export" 탭에 프로젝트의 클래스패스의 모든 항목들이 포함되어 있다. 이들 항목 들 중에서 체크가 되어진 것은 노출(Exported)된 것인데,이들 항목은 이 프로젝트에 의존적인 모든 프로젝트의 클래스패스에 자동으로 추가된다. 예를들어 우리가 joda-time-098.jar 항목을 체크하였다면 자동으로 "other" 프로젝트의 클래스패스에 추가된다.



어떤 항목이든 선택하여 클래스패스에서의 순서를 "Up", "Down" 버튼을 사용하여 변경할 수 있다.

java.net 어플리케이션들을 위한 단일 프로젝트 사용하기 만일 여러분이 java.net에 호스팅 하고자 하는 어플리케이션을 생성하려고 한다면 하나의 프로젝트를 이용하라. 그렇게 하는 것이 CVS로 작업하는데 더 용이하다. 만일 어플리케이션 코드의 다른 부분을 별도로 관리하기를 원한다면 소스 폴더를 활용하라. 외부의 이클립스 프로젝트를 사용하기를 원하는 경우, 예를 들어 java.net에 위치한 또 다른 이클립스 기반 프로젝트를 사용하려고 한다면, 앞서 설명한 프로젝트 의존성을 활용하는 것보다는 외부의 프로젝트를 JAR 파일로 압축해서 사용하라.

플러그인의 설치

이클립스에는 새로운 플러그인을 찾아 설치하기 위한 그래픽 유저 인터페이스가 있다. Help->Software Updates->Fild and install 메뉴 항목을 통해서 접근할 수 있다. 그러나, 아래 설명하는 방법과 같이 수작업으로 직접 설치하는 것이 더 편리하다.

먼저 여러분이 설치하길 원하는 플러인을 다운로드 받는다. http://eclipse-plugins.2y.net/eclipse/index.jsp 사이트와 http://www.eclipseplugincentral.com/ 사이트에 있는 온라인 색인을 통해 좀 더 쉽게 찾을 수 있다.

필요하다면 zip이나 tar형태로 압축된 플러그인의 압축을 푼다. "plugin.xml" 파일이 있는 디렉토리 찾아서 디렉토리를 Eclipse가 설치되어 있는 디렉토리(예를들어 C:eclipseeclipse-SDK-3.0.1-win32eclipseplugins.) 아래의 "plugins" 디렉토리로 복사한다. 이클립스를 다시 시작하면 플러그인을 사용할 수 있는 상태가 된다. (종종 플러그인은 사용자가 직접 사용을 하게 되는 경우에 새로운 뷰나 에디터, 퍼스펙티브를 제공한다.)

만약 플러그인이 로드되었는지 의심스럽다면 Help->About Eclipse Platform을 선택하고 "Plug-in Details"를 선택해보면 된다.



이렇게 하면 로드된 모든 플러그인을 볼 수 있다.

요약

이클립스가 무엇인지 그리고 오픈소스개발을 위하여 프로젝트를 어떻게 설정하는지 익혔기를 바란다. 2부에서는 java.net의 CVS 저장소와 함께 이클립스에 통합된 CVS를 사용하는 방법을 살펴본다.

저자와 역자

Martin Pllu: Edinburgh에 있는 Standard Life Assurance사의 메세징 & Java 기반 팀의 멤버이다. java.net에 호스트 되어있는 leafcutter and tracetest같은 오픈소스 어플리케이션의 개발자이기도 하다.


역자 : 안영회, 최한수