중요:
이 섹션은 톰캣 빌드를 위한 지원이 아니고, 보장되지 않았다.
이 섹션 이전의 Ant 빌드를 설명한 부분만이 지원된다.
그러나, 어떤 개발자들은 Java IDE를 이용해서 자바코드를 다루고 싶어하므로
다음에 설명할 단계들이 유용할 것이다.
This is not a supported means of building Tomcat; this information is
provided without warranty :-).
The only supported means of building Tomcat is with the Ant build described above.
However, some developers like to work on Java code with a Java IDE,
and the following steps have been used by some developers.
참고:
모든 빌드 단계가 이클립스 아래에서 진행되지 않는다. 빌드 과정의 많은 부분에서
Ant가 필요하다. 그러나 자바 코드를 보거나 수정할 수 있고, 경고를 찾거나
코드 수정 및 리팩토링이 가능하고, IDE에서 톰캣을 실행할 수 있다.
This will not let you build everything under Eclipse;
the build process requires use of Ant for the many stages that aren't
simple Java compilations.
However, it will allow you to view and edit the Java code,
get warnings, reformat code, perform refactorings, run Tomcat
under the IDE, and so on.
경고:
Ant 실행전에 ${tomcat.source}/build.properties 파일을 만들고
이전 섹션과 같이 설정하는 것을 잊지 말라.
Do not forget to create and configure
${tomcat.source}/build.properties file as described above
before running any Ant targets.
이클립스 샘플 프로젝트 파일과 런치 타겟들이 소스트리의 res/ide-support/eclipse
에 제공된다. 아래의 명령이 자동으로 이 파일들을 필요한 위치로 카피한다.
Sample Eclipse project files and launch targets are provided in the
res/ide-support/eclipse directory of the source tree.
The instructions below will automatically copy these into the required locations.
Ant 타겟은 모든 의존성 바이너리 다운로드의 편의성을 위해 제공되고, 이클립스 프로젝트와 클래스패스 파일들을
소스 트리의 루트에 생성한다.
An Ant target is provided as a convenience to download all binary dependencies, and to create
the Eclipse project and classpath files in the root of the source tree.
cd ${tomcat.source}
ant ide-eclipse
이클립스를 시작하고 새로운 Workspace를 만든다.
Preferences 다이얼로그를 열고 Java->Build Path->Classpath
Variables를 선택한 후 두 개의 Classpath Variables를 추가한다:
| TOMCAT_LIBS_BASE |
build.properties에 설정된 base.path와 같은 위치이며,
이는 의존성 바이너리가 다운로드된 디레토리 |
| ANT_HOME | Ant 1.8.1 나 이후 버전의 기본 위치 |
File->Import를 클릭하고 Existing Projects into Workspace를 선택한다.
톰캣 소스 트리 (${tomcat.source})의 루트 디렉토리를 찾아 톰캣 프로젝트를 임포트 한다.
start-tomcat 과 stop-tomcat 실행 설정은
res/ide-support/eclipse에 있으며, Run->Run Configurations다이얼로그에서 사용할 수 있다.
이를 이클립스에서 톰캣을 시작/중지하는데 사용하라.
이를 변경하거나 다른 IDE에서 사용하고 싶다면
org.apache.catalina.startup.Bootstrap를 메인 클래스로 하여
start/stop를 프로그램 인자로 이용하고, -Dcatalina.home=...
(빌드 디렉토리 이름과 함께)를 VM 인자로 지정한다.
이클립스의 몇몇 preference를 수정하는 것이 톰캣 코딩 컨벤션의 일관성을 유지하는데 도움을 줄 것이다.
(톰캣 기여에 있어서도 필요하다)
| Java -> Code Style -> Formatter -> Edit... |
Tab policy: Spaces only
Tab and Indentation size: 4 |
| General -> Editors -> Text Editors |
Displayed tab width: 2
Insert spaces for tabs
Show whitespace characters (optional) |
| XML -> XML Files -> Editor | Indent using spaces
Indentation size: 2 |
| Ant -> Editor -> Formatter | Tab size: 2
Use tab character instead of spaces: unchecked |
