Web Tools Project(이하 WTP) 기반하에서 웹 프로젝트 생성 및 실행

이 문서는 WTP 기반하에서 웹 프로젝트를 생성한 다음 간단한 웹 애플리케이션 예제를 실행하는 과정에 대하여 다룬다. Eclipse 기반하에서 WTP를 이용하여 웹 개발을 어떻게 진행할 수 있는지에 대하여 알 수 있다.

Table of Contents

• WTP 기반하에서 웹 프로젝트를 위한 사전 요구사항
• Tomcat 서버 설정
• 프로젝트 생성
• 자바 예제 소스 생성
• JSP 예제 소스 생성
• 예제 실행 및 디버깅
• 브라우저 설정
• 다양한 문제 해결 방법
  • JSP Editor에서 한글이 깨질 경우
• 문서를 마치며

WTP 기반하에서 웹 프로젝트를 위한 사전 요구사항

WTP 기반하에서 웹 프로젝트를 진행하기 위해서는 웹 프로젝트를 실행하기 위한 애플리케이션 서버가 설치되어 있어야 한다. WTP는 Apache Tomcat v3.2, v4.0, v4.1, v5.0를 지원하고 있다. 이 강좌는 WTP에서 제공하고 있는 Tomcat 플러그인을 이용하여 웹 애플리케이션을 실행한다.

먼저 자카르타 프로젝트에서 테스트하고자하는 Tomcat 버전을 다운받는다. WTP의 Tomcat 플러그인을 이용하여 웹 애플리케이션을 실행은 JDK가 설치된 시스템에서 가능하다. JRE만 설치된 시스템에서는 실행되지 않는다. 따라서 JRE만 설치되어 있는 상태라면 JDK를 다운받아서 설치한다.

Tomcat 서버 설정

• File | New | Other.. | Server | Server를 선택한 다음 Next

• Apache 하위에서 자신의 로컬에 설치한 Apache Tomcat을 선택 > Next. 이 문서는 Apache Tomcat 5.0.28을 사용하였다.

• 현재 생성되어 있는 프로젝트가 없으므로 빈 상태에서 Finish

• Server 세팅을 완료하면 앞에서 설정한 정보를 포함하는 Servers 프로젝트가 생성된다.

프로젝트 생성

• File | New | Project | Web으로 이동한 다음 J2EE Web Project를 선택 > Next.

• 프로젝트 이름 입력(예 javajigi), Tomcat 버전과 서블릿 버전을 선택한다. Target Server는 앞에서 설정한 Apache Tomcat 5.0을 선택한다. 서블릿 버전을 2.3을 사용한다. Tomcat은 EJB를 지원하지 않기 때문에 'Add module to an EAR Project'의 체크 박스를 해제한다. > Finish.

• J2EE Project가 정상적으로 생성되면 아래 화면과 같이 생성되는 것을 확인할 수 있다.

자바 예제 소스 생성

• 예제를 단순화하기 위하여 프로젝트를 처음 시작할 때 자주 사용하는 Hello World 예제를 생성해보도록 하겠다.
• Java Browsing Perspective로 이동하면 javajigi 프로젝트를 확인할 수 있다. J2EE Project에서 디폴트로 생성되는 자바소스 디렉토리는 JavaSource이다.
• 이 문서에서는 helloWorld 메써드를 가지는 HelloWorld 클래스를 net.javajigi.sample 패키지에 생성하였다.

    

package net.javajigi.sample;

public class HelloWorld {
	public String helloWorld(String name) {
		
		return "Hello Worldh2." + name;
	}
}  

JSP 예제 소스 생성

• 앞에서 생성한 HelloWorld 클래스를 JSP에서 호출하는 과정을 보이기 위하여 다음과 같이 간단한 JSP 예제를 생성해보자.
• Resources Perspective로 이동한 다음 javajigi > WebContent 하위에 다음과 같은 예제의 helloworld.jsp파일을 생성한다.

    

<%@ page contentType="text/html;charset=UTF-8"%>
<%@ page import="net.javajigi.sample.HelloWorld" %>

<%
	HelloWorld hello = new HelloWorld();
	
	out.println(hello.helloWorld("javajigi"));
%> 

helloworld.jsp 파일을 복사하지 말고 직접 작성해보기 바란다. WTP에서 지원하는 기능들을 확인해볼 수 있을 것이다. 우리가 Eclipse의 JDT(Java Development Tools)를 사용하면서 느꼈던 장점들을 JSP 파일을 작성하면서도 그대로 느낄 수 있을 것이다. 컴파일 에러에 대한 체크 등 jsp를 작성하면서 그 동안 불편하게 느꼈던 부분을 해결해주고 있다는 것을 느낄 수 있다.

예제 실행 및 디버깅

• 다음은 앞에서 작성한 예제를 실행해볼 때이다. javajigi 프로젝트에서 오른쪽 클릭 | Run As | Run on Server 선택. 현재 사용가능한 Server가 나타난다. > Next

• 선택한 서버에서 구동할 프로젝트를 선택한다. 이 문서에서는 javajigi 프로젝트를 사용하였다. > Finish

• 선택한 Tomcat 5.0 서버가 실행되는 것을 확인할 수 있다.

• WTP는 JSP를 실행한 결과를 확인할 수 있는 Web Browser를 포함하고 있다. Tomcat 서버를 시작하면 웹 브라우저가 열리면서 helloworld.jsp를 바로 실행해 볼 수 있다. helloworld.jsp를 실행한 결과는 다음과 같다.

• 다음은 자바 소스를 변경할 경우 서버의 재시작 없이 반영이 되는지를 확인해 보도록 하겠다. HelloWorld클래스의 helloWorld 메써드를 다음과 같이 수정해보겠다.

    

package net.javajigi.sample;

public class HelloWorld {
	public String helloWorld(String name) {
		
		return "Hello Worldh2." + name + " HeHeh2.";
	}
}  

• 자바소스를 수정 한 다음 저장을 하면 Eclipse Console화면에 다음과 같은 메세지가 뜨는 것을 확인할 수 있다.

• 위 메세지를 보면 Tomcat Context가 reload된 것으로 생각된다. 그렇다면 브라우저 상에서도 수정된 소스가 반영된 것을 확인할 수 있다.

• Tomcat Context가 reload되는 시간은 1초 이내로 저장하는 순간 바로 reload되는 것을 확인할 수 있었다. 지금까지 자바 소스의 reload가 제대로 되지 않아 서버를 재시작하는 불편함을 덜어도 될 것으로 생각한다.

• WTP의 Debug 기능을 사용하기 위해서는 Tomcat 서버를 시작할 때 Debug 모드로 시작해야 한다. Debug 모드로 시작한 다음 JSP 파일이나 자바 소스 파일의 특정 위치에 Break Point를 설정한 다음 디버깅이 가능한지 확인해 보기 바란다. 디버깅 또한 잘 되는 것을 확인할 수 있다.

브라우저 설정

• Window | Preferences | Internet | Web Browser로 이동하면 JSP를 테스트하기 위하여 사용하고자하는 브라우저를 설정하는 것이 가능하다.

다양한 문제 해결 방법

JSP Editor에서 한글이 깨질 경우

WTP를 처음 설치하고 JSP Editor에서 한글을 입력할 경우 한글이 깨질 것이다. 이처럼 한글 깨질 때는 Window | Preferences | Web and XML로 이동한 다음 JSP Files 항목에서 Encoding을 EUC-KR 또는 UTF-8로 설정하면 된다.

 lineNumbers='true'   

<%@ page contentType="text/html;charset=UTF-8"%>
또는 
<%@ page contentType="text/html;charset=EUC-KR"%> 

문서를 마치며

WTP에서 제공하는 Tomcat Server 플러그인을 사용해볼 결과 그 동안 웹 개발을 하면서 불편하게 느꼈던 대부분의 문제들을 모두 해결하고 있다는 것이다. 현재는 Tomcat Server 플러그인만 지원하고 있지만 향후 다른 WAS 플러그인들도 WTP에서 제공하는 플러그인 API를 바탕으로 그 같은 기능을 제공하는 것이 어렵지 않을 것으로 생각한다.
EJB 개발 편의성 또한 어느 정도의 기능을 지원하고 있는지는 분석해봐야하겠지만 J2SE환경하에서 개발하는 개발자들이 많은 환경하에서는 상당히 반가운 소식이 아닐 수 없다.
아직 WTP가 개발 진행중이 플러그인이지만 조만간 최종 배포되고 난 후 수 많은 개발자들이 이 플러그인의 혜택을 볼 수 있을 것으로 생각한다.

강좌에 대하여

작성자 : 박재성
작성일 : 2005년 3월 9일
상태 : 작업 진행중
문서이력 :

• 2005년 3월 9일 박재성 문서 최초 생성 : WTP 플러그인에서 기반하에서 웹 프로젝트 생성 및 실행에 대한 초안 마련(M3)
• 2005년 3월 31일 박재성 문서 수정 : JSP Editor에서 한글이 깨질 경우에 대한 해결책 제시

추가적으로 문서 작업 필요한 부분 :

• Servlet, Custom Tag 개발 및 사용에 대한 내용 추가해야 함.
• WTP를 활용하여 웹 프로젝트를 어떻게 하면 효율적으로 진행하여 생산성을 향상 시킬 수 있는지에 대한 문서화 작업.