새로운 자바 웹 애플리케이션을 작성
새로운 자바 웹 애플리케이션을 작성을 위해 먼저 디렉토리부터 생성해야 합니다.
새로운 웹 애플리케이션의 소스가 위치할 디렉토리명을 bbs 라면 아래와 같이 디렉토리를 생성합니다.
- /bbs
- /bbs/WEB-INF
- /bbs/WEB-INF/classes
- /bbs/WEB-INF/lib
새로운 웹 애플리케이션의 디렉토리가 만들어졌다면 다음으로 Tomcat 이 새로운 웹 애플리케이션을 인지하도록 해야 하는 작업이 남았습니다.
Tomcat 은 웹 애플리케이션을 관리할 때 XML 파일을 이용합니다.
이 XML 문서에서 최상위 엘리먼트 이름이 Context 입니다. Context 는 Tomcat 에게는 웹 애플리케이션을 의미합니다.
그래서 이 XML 문서를 Context 파일이라고 합니다.
Tomcat 5.x 버전부터는 웹 애플리케이션마다 Context 파일이 각각 있어야 합니다.
Context 파일에서 가장 중요한 정보는 웹 애플리케이션의 소스가 위치하는 루트 디렉토리(Document Base 또는 Context Root)와
URL로 접근하는 경로 정보(Context Path)입니다.
Context 파일은 작성 후 {Tomcat 홈}\conf\Catalina\localhost 디렉토리에 위치시킵니다.
bbs 웹 애플리케이션의 Context 파일을 만든 다음 {Tomcat 홈}\conf\Catalina\localhost 디렉토리에 위치하도록 하면 Tomcat 은
자동으로 bbs 웹 애플리케이션을 로드합니다.
Context 파일은 XML 파일이기 때문에 XML 문법에 어긋나면 웹 애플리케이션을 Tomcat 이 로드하지 못합니다.
그래서 Context 파일을 자동으로 생성해주는 툴을 사용하면 좋겠지만 Tomcat 에서 제공하는 Admin 툴은 윈도우 시스템에서 테스트 한 결과
Context 파일을 만들어 내지 못합니다.
따라서 직접 편집기를 통해 Context 파일을 만드는 것이 윈도우 시스템에서 확실합니다.
먼저 Tomcat Admin 툴을 이용하여 Tomcat 에게 새로운 웹 애플리케이션을 등록하고 로드 해 보겠습니다.
1. Tomcat Admin 툴을 이용한 새로운 Context 작성
먼저 Admin 툴을 다운로드 해야 합니다.
Admin 툴이라고 했는데 이것 역시 자바 웹 애플리케이션입니다.
Admin 툴은 Tomcat 을 관리하기 위해 사용합니다.
Tomcat 을 다운로드 했던 http://tomcat.apache.org/download-55.cgi
에서 Administration Web Application 의 zip 형태를 다운로드 합니다.
압축을 푼 후 conf/Catalina/localhost 디렉토리에 있는 admin.xml 파일은 {Tomcat 홈}/conf/Catalina/localhost
디렉토리에, server/webapps/ 에 있는 admin 디렉토리는 {Tomcat 홈}/server/webapps/ 에 각각 복사합니다.
Tomcat 을 다시 실행한 다음 http://localhost:8080/admin 으로 방문합니다.
로그인 화면에서 User Name 는 admin, Password 는 admin 패스워드를 입력하여 로그인 합니다.
만약 설치과정 중 정했던 admin 의 패스워드가 생각나지 않는다면 {Tomcat 홈}/conf/tomcat-users.xml 에서 확인할 수 있습니다.
tomcat-users.xml
<?xml version='1.0' encoding='utf-8'?> <tomcat-users> <role rolename="tomcat"/> <role rolename="role1"/> <role rolename="manager"/> <role rolename="admin"/> <user username="tomcat" password="tomcat" roles="tomcat"/> <user username="role1" password="tomcat" roles="role1"/> <user username="both" password="tomcat" roles="tomcat,role1"/> <user username="admin" password="jerry" roles="admin,manager"/> </tomcat-users>
위의 파일대로라면 admin 의 패스워드는 jerry 입니다.
왼쪽 메뉴에서 Tomcat Server >> Service >> host(localhost) 를 선택하고 오른쪽에 위치한 셀렉트 메뉴에서
Create New context 를 선택하여 설정화면이 나오면 아래와 같이 설정합니다.
위의 설정 중 Document Base 부분은 여러분 자신의 환경에 맞게 고칩니다.
설정한 후 상단 버튼 save 와 commit changes 를 차례로 클릭한 후 로그아웃 하고 우리가 설정한 웹 애플리케이션의 URL를 방문합니다.
http://localhost:8080/bbs 로 방문하여 bbs 웹 애플리케이션이 작동하는지 확인합니다.
Context Properties
| Context Properties (Admin 툴화면) |
Context Attribute (Context 파일) |
기본값 | 설명 |
|---|---|---|---|
| Cookies | cookies | true | 쿠키를 사용여부 설정한다. 쿠키나 세션을 사용하는 웹 애플리케이션이라면 true 이어야 한다. |
| Cross Context | crossContext | false |
만약 true 이면 ServletContext.getContext() 메소드를 통해 다른 웹 애플리게이션에 대한 request dispatcher
를 리턴받을 수 있다. 이것은 웹 애플리케이션에서 다른 웹 애플리케이션에 대한 접근을 허용함을 의미한다. 보안을 위해서라면 false로 설정한다. 그러면 ServletContext.getContext() 는 항상 null 을 리턴한다. |
| Document Base | docBase | 웹 애플리케이션의 소스가 위치할 루트 디렉토리(이를 Document Base 또는 Context Root 라 한다.)를 지정한다. | |
| Path | path | 웹 애플리케이션에 접속할 URL 를 지정한다. 이를 다른 말로 context path 라 한다. 만일 path 가 XML Context 파일명과 같다면 생략 가능하다. | |
| Reloadable | reloadable | true |
WEB-INF/classes,WEB-INF/lib 디렉토리 있는 클래스나 jar 파일이 변경되면 자동으로 변경된 내용을 읽어드린다. 새로운 웹 애플리케이션을 개발하거나 개발하는 과정에서는 true 로 해서 작업 편의성을 가질 수 있지만 실제로 서비스를 운영할 때는 성능문제로 false로 둔다. |
| SwallowOutput | swallowOutput | false | true 로 설정하면 웹 애플리케이션에서 발생하는 System.out 이나 System.err 출력이 로그 파일로 전달된다. |
| Use Naming | useNaming | true | JNDI를 지원할 것인지 설정한다. |
참고문서
http://tomcat.apache.org/tomcat-5.5-doc/config/printer/context.html
2. 편집으로 새로운 Context 작성
만약에 어떤 이유로 Tomcat Admin 툴이 제 기능을 못해서 새로운 Context 작성을 할 수 없다면 수동으로 편집하면 됩니다.
위에서 Admin 툴로 설정한 내용대로 bbs 웹 애플리케이션을 위한 XML Context 파일을 만들어 보겠습니다.
bbs.xml
<?xml version="1.0" encoding="UTF-8"?>
<Context
<!-- path="/bbs" Context 파일명이 bbs.xml 이면 생략 가능 -->
docBase="D:/www/bbs"
reloadable="true">
</Context>
bbs.xml 파일을 만든 후 {Tomcat 홈}/conf/Catalina/localhost 에 복사합니다.
bbs 웹 애플리케이션의 최상의 디렉토리에 index.jsp 파일을 테스트용으로 만듭니다.
http://localhost:8080/bbs 방문하여 index.jsp 가 실행이 되는지 확인합니다.
ROOT 애플리케이션의 Document Base 변경 방법
Tomcat 을 설치하고 http://localhost:8080/index.jsp 로 접근할 수 있는 웹 애플리케이션이 ROOT 애플리케이션입니다.
이 웹 애플리케이션의 Document Base 는 {Tomcat 홈}/webapps/ROOT 입니다.
ROOT 웹애플리케이션의 Document Base 는 Admin 툴로 수정할 수 없기 때문에 수작업으로 ROOT.xml 파일을 만들어 수정해야 합니다.
ROOT.xml 파일을 만들고{Tomcat 홈}/conf/Catalina/localhost 에 복사하고 Tomcat 을 다시 시작합니다.
ROOT.xml
<?xml version="1.0" encoding="UTF-8"?>
<Context
docBase="D:/www/bbs"
reloadable="true">
</Context>
- 다음 강좌 : 서블릿 문법
- 이전 강좌 : "자바 웹 애플리케이션" 이란?