Installation

다음에서는 Anyframe Web 최신 버전에 대해 Anyframe Web 설치 및 개발 환경 셋팅으로 구분하여 설명을 진행한다. 먼저 다운로드 페이지 를 통해 Anyframe Web(Binary)을 다운로드한 후 적절한 위치에 압축을 해제하면 다음과 같은 파일들이 존재한다.

Anyframe Web 기반 개발을 위해서는 반드시 Anyframe Core를 미리 설치하고 Anyframe Web을 설치해 주어야 한다. Anyframe Core 버전은 Anyframe Web의 버전과 무관하므로 필요한 버전을 설치하면 된다.

설치 환경

Anyframe Web의 설치 환경은 Anyframe Core 설치 환경과 동일하며 내용은 아래와 같다.
  • JDK 1.4.2 이상(일부기능 : Annotation - JDK 1.5이상)
  • Web Container - Tomcat 5.0.28 이상, WebLogic 8.1.6 이상, JEUS 5.0 이상
  • DataBase - HsqlDB 1.8.0.10, Oracle 8i, MS SQL Server ~ 이상
  • Eclipse 3.2.2 이상
본 문서에서는 기본적으로 Tomcat5.5 및 eclipse 3.3.1(WTP 포함)을 기준으로 설치 가이드를 진행할 것이다. 또한, Eclipse에 대해서는 Anyframe에서 제공하는 eclipse 기반 툴셋(Tomcat 5.5 포함)을 기반으로 설명을 진행할 것이다.

설치

Apache ANT를 이용하여 다음과 같이 [압축 해제 위치] 내의 install.xml을 실행한다.
  • 명령창에 ant -f install.xml와 같이 입력하여 install.xml을 실행한다.
  • [input] Define Install Directory. (ex. C:/anyframe/lib) : [C:/anyframe/lib]와 같은 질문이 나오면, Anyframe Core를 설치한 경로를 입력하고 엔터키를 누른다. 설치 경로 미입력시 C:/anyframe/lib에 설치된다.


  • [echo] What framework do you select (SpringMVC or Struts)?
    [input] If you want to select SpringMVC, then input 1. Else input 2 : (1, 2) 와 같은 질문이 나오면, Anyframe Web을 Spring MVC로 설치할 것이면 1을 Struts로 설치할 것이면 2를 입력하고 엔터키를 누른다.


  • 다음과 같이 BUILD SUCCESSFUL이 되면, Anyframe Web 라이브러리 설치 작업은 성공적으로 끝난 것이다.



    • 이하 문서에서 [Anyframe Web 설치 폴더]라 함은 앞서 입력한 설치 경로로 간주한다.

개발 환경 셋팅

위 작업이 정상적으로 완료된 후, Eclipse 내에 Anyframe 기반의 개발 환경을 셋업하기 위해서는 다음과 같은 절차를 따르면 된다.
  • Anyframe_LIB에 Anyframe Web 라이브러리 추가
  • Eclipse Web 프로젝트 구성

[필수] Step 1 : Anyframe_LIB에 Anyframe Web 라이브러리 추가

Anyframe Core 매뉴얼 >> Installation >> 개발 환경 셋팅 에서 언급했듯이 Eclipse 환경 설정의 편의를 위해 Anyframe_LIB 이라는 User Library를 정의해두었다. Anyframe Web 설치 후에는 Anyframe_LIB에 설치된 Anyframe Web 라이브러리 추가 작업이 뒤따라야 한다.
  1. Eclipse를 실행시킨다.
  2. Window > Preferences... 메뉴를 선택한다.
  3. Preferences 창의 좌측 메뉴에서 Java > Build Path > User Libraries를 선택한다.
  4. Preferences 창의 오른쪽 화면에서 이미 추가된 Anyframe_LIB을 선택하고 Add JARs 버튼을 클릭한다.
  5. [Anyframe Web 설치 폴더] 내의 모든 jar 파일들을 선택하고 OK 버튼을 클릭한다.

[선택] Step 2 : Web 프로젝트 구성

다음과 같은 순서로 신규 Eclipse Web Project를 생성할 수 있다. Anyframe 에서는 Web 프로젝트 구성시, Eclipse 내에서 개발/디버그/실행이 가능하도록 프로젝트 유형을 Dynamic Web Project로 선택할 것을 권장한다.
  1. Eclipse를 실행시킨다.
  2. File > New > Projcet... 메뉴를 선택한다.
  3. 프로젝트 유형으로 New Project Wizard에서 Web > Dynamic Web Project를 선택하고 Next 버튼을 클릭한다.
  4. Eclipse 프로젝트명 및 경로, 런타임 서버, Context Root, Content Directory 등을 정의하여 신규 Web Project를 생성한다.
    • 신규 Web Project의 [Content Directory] 폴더를 선택하고 Context 메뉴 Import를 선택한다.
    • General > File System을 선택하고 Next 버튼을 클릭한다.
    • From Directory 항목에 대해 Browse 버튼을 클릭하여 [Core Framework 설치 폴더]를 선택한 후, From Directory 항목의 아래의 왼쪽 선택창에서 해당하는 폴더명을 선택한다.
    • From Directory 항목의 아래의 오른쪽 선택 창에서, WAS에서 기본적으로 제공하는 라이브러리인 j2ee, weblogic, xbean, xalan, xjb 등과 같은 라이브러리를 제외한 모든 라이브러리를 선택한 후, Finish 버튼을 클릭한다.
※ 위에서 WEB-INF/lib에 라이브러리를 추가하지 않고 User Library 셋팅을 통한 라이브러리 참조도 가능하다. Sever 프로젝트 구성을 참조하여 해당 Web 프로젝트의 Build Path에 User Library인 Anyframe_LIB을 추가함으로써, Anyframe 기반 개발 환경을 갖출 수도 있다. 단, Anyfram_LIB에 포함되는 라이브러리는 [Anyframe Core, Web 설치 폴더]내의 모든 라이브러리로 한다. Anyframe_LIB 설정 방법은 Anyframe Core 설치 문서에서 설명되었으며 여기 를 참고한다. 하지만 이경우 Web Project를 war파일로 배포할시 따로 라이브러리 참조위치를 지정해줘야한다.