개발 프로세스 Development Processes

어플리케이션 개발 방식이 여러가지가 있지만, 이 매뉴얼은 톰캣으로 웹 어플리케이션을 만들기 위한 아주 보편적인 처리과정을 제안하려합니다. 아래의 섹션들은 코드 개발자로서 실행시킬 명령어들과 작업들에 대해 조명하겠습니다. 만일 적당한 소스 코드 제어 시스템을 사용하고, 주어진 시간에 애플리케이션의 어느 부분을 작업할지에 대한 내부적인 팀의 규칙이 있다면, 여러 개발자가 같이 작업하는 동안에도, 동일한 기본적인 접근방식을 적용해도 괜찮을 것입니다.

아래의 작업 설명은 소스 코드 관리에 CVS 를 사용하고, 적당한 CVS 저장소에 접근하도록 설정되어있다고 가정합니다. 이에 대한 자세한 설명은 이 매뉴얼을 범주를 벗어납니다. 다른 소스 코드 관리 환경을 사용한다면, 해당 시스템에 맞는 적절한 명령어를 생각해보셔야겠습니다.

개발을 위한 ant와 톰캣의 한방 설치 One-Time Setup of Ant and Tomcat for Development

Manager 웹 어플리케이션을 사용하는 앤트의 특수 기능을 사용하기 위해서는, (개발할 웹 어플리케이션의 수에 상관없이) 처음 한 번은 다음 작업을 해 놓아야 됩니다. 앤트 사용자 작업 설정하기. 앤트 사용자 작업을 위한 구현 코드는 JAR 압축된 $CATALINA_HOME/server/lib/catalina-ant.jar 파일에 들어 있습니다. 이 파일을 앤트가 설치된 디렉토리 아래의 lib에 복사해야 됩니다. 하나 이상의 톰캣 사용자 정의하기. Manager 웹 어플리케이션은 보안 제약이 걸려있기 때문에 사용자의 로그인이 필요하고, 보안 역할 manager 가 할당되어 있어야 됩니다. 그러한 사용자들은 톰캣의 conf/server.xml 파일에 설정된 Realm 에 따라서 정해집니다 -- 자세한 내용은 Realm Configuration HOW-TO 를 참고하세요. manager 역할을 가진 사용자(username 과 password를 가진)들의 수는 상관없이 만들 수 있습니다.

프로젝트 소스 코드 디렉토리 만들기 Create Project Source Code Directory

첫단계는 새로운 프로젝트 소스 디렉토리를 만들고, 사용할 build.xml 와 build.properties 파일을 적절하게 수정하는 일입니다. 디렉토리 구조는 지난 섹션에서 설명했고, 시작 예제로 주어진 sample 어플리케이션 을 사용해도 좋습니다. 프로젝트 소스 디렉토리를 생성하고, 그것을 CVS 저장소에 등록합니다. 아래의 몇 줄의 명령어들을 사용해서 등록할 수 있습니다. 아래의 {project}는 CVS 저장소에 저장될 프로젝트 명이고, {username}은 로그인 사용자명입니다: cd {my home directory} mkdir myapp <-- "프로젝트 소스 디렉토리"로 가정합니다. cd myapp mkdir docs mkdir src mkdir web mkdir web/WEB-INF cvs import -m "Initial Project Creation" {project} \ {username} start 이제, CVS 에 제대로 등록되었는지 확인합니다. 새로운 프로젝트를 체크아웃해 보겠습니다 cd .. mv myapp myapp.bu cvs checkout {project} 다음으로, 개발에 사용할 초기 버전의 build.xml 스크립트를 만들어서 체크인해야 됩니다. 빠르고 쉽게 시작하기 위해서, 이 매뉴얼에 포함된 기본 build.xml 파일을 수정한 build.xml 파일을 기초로 하십시오. cd {my home directory} cd myapp emacs build.xml <-- 사용할 수 있다면 :-) , 아니면 다른 텍스트 편집기 cvs add build.xml cvs commit CVS 커밋(commit)을 수행할 때까지, 변경사항은 작업자의 개발디렉토리에만 저장됩니다. 커밋을 수행하면 같이 CVS 저장소를 사용하는 팀원들이 변경사항을 볼 수 있게됩니다. 다음 단계는 앤트의 build.xml 스크립트에 있는 properties를 프로젝트에 맞게 수정하는 것입니다. 같은 역할을 하는 다른 방법은 프로젝트 최상위 디렉토리에 build.properties 파일을 생성하는 것입니다. 지원되어야 될 프로퍼티 목록은 예제 build.xml 스크립트의 주석에 잘 설명되어 있습니다. 최소한, 일반적으로 톰캣 4가 설치된 곳을 가리키는 catalina.home 프로퍼티와 manager 어플리케이션 username 과 password 정도는 수정을 해줘야 될 것입니다. 아래처럼 작업하면 될 것입니다: # 이 어플리케이션이 설치될 컨텍스트 이름 app.path=/hello # 톰캣 4 설치 디렉토리 catalina.home=/usr/local/jakarta-tomcat-4.0 # Manager 웹 어플리케이션 username 과 password manager.username=myusername manager.password=mypassword 일반적으로, build.properties 파일은 CVS 저장소에 올려 놓지 않습니다. 왜냐하면 개발자 각각의 환경마다 다르기 때문입니다. 이제, 웹 어플리케이션 배치 설명서의 초기 버전을 만듭니다. 기본 web.xml 파일로 web.xml 기반을 삼아도 괜찮습니다. cd {my home directory} cd myapp/web/WEB-INF emacs web.xml cvs add web.xml cvs commit

소스코드와 페이지 수정 Edit Source Code and Pages

개발과 유지보수하는 동안 주로 하는 작업은 수정/빌드/테스트 가 될 것입니다. 다음의 일반적인 원리를 적용하십시오. 소스 구성 에서 설명한 것처럼, 새롭개 만들어진 소스 파일은 프로젝트 소스 디렉토리에서 적당한 서브디렉토리에 위치해야 됩니다. 다른 개발자가 작업한 내용을 지금 개발중인 디렉토리에 반영하도록 갱신하려면, CVS 를 통해서 받아와야 됩니다: cd {my home directory} cd myapp cvs update -dP 새로운 파일을 만들기 위해서, 적당한 디렉토리로 이동한 뒤에, 파일을 만들고, CVS 에 그 파일을 등록합니다. (빌드와 테스트를 성공적으로 마친 뒤) 만족할만한 소스가 만들어지면, 저장소에 새 파일을 커밋합니다. 예를 들어, 새로운 JSP 페이지를 만든다면: cd {my home directory} cd myapp/web <-- 궁극적인 목적지는 문서 루트 emacs mypage.jsp cvs add mypage.jsp ... 어플리케이션 빌드와 테스트 ... cvs commit 패키지 선언된 자바 소스 코드는 (src/ 서브디렉토리 아래에) 패키지 명에 맞게 디렉토리 체계로 위치해야 됩니다. 예를 들어 완전 자바 클래스명이 com.mycompany.mypackage.MyClass.java 인 파일은 src/com/mycompany/mypackage/MyClass.java 로 저장되어 있어야 됩니다. 새로운 디렉토리를 만들 때마다, CVS 에 등록하는 것을 잊지 마십시오. 기존 소스 파일을 수정하려면, 일반적으로 수정과 테스트를 바로 시작합니다. 그리고, 작업이 완료된면 변경된 파일을 커밋합니다. CVS 설정으로 수정중인 파일을 "check out" 하면 "lock" 을 걸어 잠그는 기능이 지원되지만, 일반적으로는 잘 사용하지 않습니다.( Although CVS can be configured to required you to "check out" or "lock" a file you are going to be modifying, this is generally not used.)

웹 어플리케이션 빌드 Build the Web Application

어플리케이션 컴파일할 준비가 되면, 다음 명령어를 수행할 차례입니다. (대개, 쉘 창에서 이미 프로젝트 소스 디렉토리에 위치하기 때문에, 마지막 명령만 수행하면 될 것입니다.): cd {my home directory} cd myapp <-- 보통은 쉘 창을 열 때 여기에 맞춰서 띄웁니다. ant 앤트는 build.xml 파일의 기본 타켓인 "compile" 을 수행합니다. 새로운 파일과 변경된 파일만 골라서 컴파일하게 됩니다. "ant clean" 을 수행한 다음에 build 디렉토리가 지워진 후에 처음 컴파일 하는 것이라면 전부 새롭게 재컴파일합니다. 전체 어플리케이션 모두 새롭게 재컴파일 하려면, 다음 명령을 사용합니다: cd {my home directory} cd myapp ant all javac의 조건 검사에서 잡아내지 못하는 미세한 문제에 의해 생기는 일이 없도록 확실하게 변경된 사항을 반영하도록 하려면, 이렇게 하는 게 좋은 습관입니다.

웹 어플리케이션 테스트 Test Your Web Application

어플리케이션을 테스트하려면, 톰캣에 설치를 해야됩니다. 가장 빠른 방법은 예제 build.xml 스크립트에 있는 커스텀 앤트 명령을 사용하는 것입니다. 이에 대한 명령어들은 다음과 같습니다: 톰캣 4를 시작합니다. 운영중이 아니라면 평상시처럼 톰캣 4를 시작합니다. 어플리케이션을 컴파일합니다. ant compile 명령을 사용해서 컴파일합니다(또는 ant만 해도 됩니다. 기본값이니까요). 컴파일 에러가 없는지 확인합니다. 어플리케이션을 설치합니다. ant install 명령을 실행합니다. build 프로퍼티에 선언된 app.path 값으로 컨텍스트 이름을 갖고 어플리케이션이 바로 시작됩니다. 설정된 것을 반영하기 위해 톰캣을 재시작하지 않습니다. 어플리케이션을 테스트합니다. 브라우저 또는 다른 테스트 도구를 사용해서, 어플리케이션의 기능을 테스트합니다. 수정하고 다시 빌드하기. 필요 요구 사항을 발견하고, 원래 소스 파일을 변경(build 디렉토리에 있는 파일이 아닙니다)한 뒤에 ant compile 명령을 다시 수행합니다. 이렇게 하면 변경사항이 적용되고, 나중에 저장(cvs commit 를 통해서)할 수도 있습니다 -- 빌드 디렉토리는 필요한 대로 삭제되고, 다시 생성됩니다. 어플리케이션 리로드하기. 톰캣은 JSP 페이지의 변경사항은 자동으로 인식합니다만, 서블릿과 자바빈 클래스들은 어플리케이션을 리로드하기 전까지는 이전 버전을 계속 사용합니다. ant reload 명령을 통해서 리로드하면 됩니다. 완료후에 어플리케이션 제거하기. 이 어플리케이션의 작업이 완료하면, ant remove 명령으로 톰캣에서 제거할 수 있습니다. 테스트 완료한 후에 작업한 소스를 소스코드 저장소에 커밋하는 것을 잊지 마십시오!

배포판 만들기 Creating a Release

새 기능 추가가 완료되고, 모든 것을 테스트하고 난 뒤에(테스트 빼먹지 않았죠 ^^), 서비스 중인 서버에 배치될 수 있는 웹 어플리케이션의 배포가능한 버전을 만들 차례가 남았습니다. 다음의 일반적인 과정이 필요합니다: 새로 모든 것을 다시 빌드하기 위해, 프로젝트 소스 디렉토리에서 ant all 명령을 실행합니다. cvs tag 명령을 실행해서 이 배포판을 만드는데 사용된 소스들에 표시를 달아둡니다. 나중에 이 버전의 신뢰할만할 소스를 다시 만드는데 필요한 것입니다. ant dist 명령을 실행해서 배포판 웹 어플리케이션 압축(WAR) 파일과 해당 소스 코드를 포함하는 JAR 파일을 생성합니다. dist 디렉토리 내용을 tar 또는 zip 유틸리티로 기존의 표준 배포판 생성 절차에 따라서 패키지를 만듭니다.