다음 이전 차례

9. cocoon 1.8

Cocoon은 official 버젼과 unofficial 버젼을 사용하여 설치를 할 수가 있다. official버젼은 까다로운 설치 및 설정을 피하기 위해 구성된 바이너리 패키지이여서 다운받아 압축을 풀고 자바 클래스만 필요한 곳에 복사를 하면 된다. 반대로 unofficial은 그렇지 않다.

cocoon 은 XML 기반의 Web publishing 을 하기 위한 100% 순수 자바 publishing Framework이다. XML을 완벽하게 지원하지 않는 브라우져를 위해 XML 관련 파일을 서버측에서 처리하여 HTML 로 변환하여 그 결과를 사용자측의 브라우져에 보여준다.

Cocoon1.8 을 다운받기를 권장하며 다운은 http://xml.apache.org 에서 하기 바란다.

또한 이 문서에서는 리눅스 기반에서 Tomcat-apache 가 설치된 상태에서 Cocoon 1.8의 official 버젼을 기준으로 설치 방법을 설명한다.

기타 필자가 XML에 관해 문외한이므로 XML 자체에 대한 설명은 불가하며 질문 또한 답변이 불가하니 참조하기 바란다.

9.1 cocoon 설치

1. 다운 받은 Cocoon 1.8 바이너리 패키지를 적당한 곳에서 압축을 푼다.

2. Cocoon 의 bin 디렉토리의 cocoon.jar 과 lib 디렉토리의 모든 *.jar 파일을 tomcat 디렉토리의 lib 디렉토리에 복사한다.

3. tomcat 디렉토리밑의 conf 디렉토리로 이동하여 server.xml을 편집한다. 아래의 라인을 적절히 추가하면 된다.

<Context path="/cocoon" docBase="webapps/cocoon" debug="0" reloadable="true">
</Context>

4. tomcat 디렉토리밑의 conf 디렉토리의 tomcat.conf에 다음의 예를 추가한다.

Alias /cocoon $TOMCAT_HOME/webapps/cocoon
<Directory "$TOMCAT_HOME/webapps/cocoon">
  Options Indexes FollowSymLinks
</Directory>
ApJServMount /cocoon /cocoon
<Location /cocoon/WEB-INF/ >
  AllowOverride None
  deny from all
</Location>

5. 아래의 예처럼 tomcat 디렉토리의 webapps 디렉토리에 디렉토리를 만든다.

mkdir $TOMCAT_HOME/webapps/cocoon
mkdir $TOMCAT_HOME/webapps/cocoon/WEB-INF 

6. 아래의 예처럼 cocoon 소스 디렉토리내의 의 web.xml 파일과 cocoon.properties 파일을 적당히 복사한다.

cp  cocoon_소스_압축푼_디렉토리/src/WEB-INF/web.xml $TOMCAT_HOME/webapps/cocoon/WEB-INF
cp  cocoon_소스_압축푼_디렉토리/conf/cocoon.properties $TOMCAT_HOME/webapps/cocoon/WEB-INF 

7. 복사된 web.xml을 수정한다.

<init-param>
...
<param-value>[path-to-cocoon]/conf/cocoon.properties</param-value>
... 
위의 부분에서 <param-value>[path-to-cocoon]/conf/cocoon.properties 을 <param-value>/WEB-INF/cocoon.properties 로 수정한다.

8. 마지막으로 아래 예처럼 cocoon 소스 디렉토리내의 samples 디렉토리를 tomcat 디렉토리애로 복사한다.

cp  cocoon_소스_압축푼_디렉토리/samples $TOMCAT_HOME/webapps/cocoon/servlets 

9.2 cocoon 테스트

cocoon 에 대한 설치 및 설정은 끝났다. 간단한 테스트를 위해 tomcat 과 apache를 기동한 후 아래의 예처럼 브라우져에 url 을 입력한다.

http://localhost/cocoon/Cocoon.xml
http://localhost/cocoon/servlets/index.xml 

참고로 Cocoon.xml 은 디스크상에 존재하는 물리적인 파일이 아니라 설정에 의해 테스트를 목적으로 하는 가상파일이니 참고하기 바란다.

테스트가 실패할 경우 위의 순서를 다시 한번 확인하기 바라며, 기타, tomcat 기동시 tomcat 의 lib 디렉토리에 있는 xerces.jar 의 클래스 로드 순서를 xml.jar 보다 먼저 로드하기 위해 xml.jar 을 zxml.jar 로 rename 하도록 하자.

더욱 자세한 내용은 http://xml.apache.org 에서 참조하기 바란다.


다음 이전 차례